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User's Guide Statement 

"This fqui])iiK'ii! tjciierates and usea radio frf(|iifncy energy', [fit is iiol [iropcrly 
InHtalifdiUKl used in siricl accnrdnncT wilh the in;im!l'ac1i.inT"s inslructicinH. I his 
equiijrtifnl may iiuertV-R' witli radio and tck'\'isi<)ti reception. Tliis niachiin- has 
tafen tested and fmind to comply wilh tiie llniits for a Class B compLitin.t; device in 
accordaneewilh the specil'ioai ions in Subpart J of Part 15 of FCC rules, which are 
designed to provide reasonable protection against such interference in a residen- 
tial installailon. If you suspect interference, you can test ihis eqiiiptneiil by turn- 
ing it off and on. If you determine that there is interference with radio or television 
rcceptioii. tn' one or more of the following measures to correct it: 

— reorient the receiving antenna 

— [no\'e the compLiter away from the receiver 

— change the rclaii\'e positions ofthe computer equipmcnl and the receiver 

— plug (he computer into a different oullel so (hat the compulei- and (he 
receiver arc on different branch circuits. 

If nccessar\-. consult your Commodore dealer or an experienced radio (ele\-ision 
technician for additional suggestions. You may also wish to consult (he following 
booklet, which was prepared by the Federal Communications Commission; 

"How lo Idenlify and Resolve Radio 1A' Interlerciice Problems" This booklet is 
available from I he U.S. Go\'ernnieni I'rini ing OITiee. Washington. D.C. 20402. Stock 
No. 004-000 0034. "5 -4." 

First Edition- 1983 
First Priming- 1983 

Copyrijtjht ;c) 1983 by Commodore Business 

Machines. Inc. 

All rights reserved. 

This manual is copyrij^htcd and contains proprietary 
inlorrnallon. No part of (his publUadon may 1)l- 
reproduced, stored in a retrieval system, or 
transmitted In any form or by any means, electronic, 
mechanical, photocopying, recording, or otherwise, 
without (he prior written permission of 
COMMODORE BUSINESS MACHINES, inc. 

Printed in (he United S(a(es of America 
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You cat! dt^sign the busiiK'ss compLUer sysfcin that best meets 
your needs by choosing one of t he Advanced Business Computers ^^J 
in Commodore's "B" Series: 

•Then- 128-80 • The CBM- 128-80 w 

• The B-256-80 • The CBM-256-80 

• The BX 1 28-80 • The CBMX- 1 28-80 " 

• The BX 256-80 • The CBMX-256 80 L^ 

The eonipuier is only one part of your business com[)uler ~ 

system. Your system should aJso include a high capacity dual -J 
lloppy or hard disk dn\e . and a dot matrix or letter qualitv prin- 
ter. Networking and telccominunieaiions accessories help extend 

yoursystem to include iiuilti]3le computers, even in diiTercnl sites. \_ 
Your Cntnmodore business dealer can tell you more about these 

peri]jhcrals. ' — 

Sollware is also important to your business system — word .■ 

processing, electronic spread sheets, account in.t^. record keep 

ing— these are just a few of the many practical functions iload ~ 

business software can provide, expecially if it's easy-to-use and _ 
"friendly" like the business programs licensed and developed bv 

Commodore for your 'B' Scries computer svstem. — 

FEATURES OVERVIEW ^ 

The computers in the 'B" Series have many common features, 
and you can add enhancements to the lower end systems to il,ivc — 
them the extra capabilities that are standard on our more sophis- ^ 
ticated systems. The fol[owln£» features are common to all 'B' 
Series computers: — 

• 80 column by 25 line screen display ^ 

• Separate calculator keyi^ad for quick computations ^ 

• 10 predefined function kevs 

• Total of 20 ea.sy-to-define function keys "^ 

• Extended BASIC version 4.0+ — 

• Expandable memoiT 

• ip:i-:i-: 488 bus " 

• KS-232C interface w 

• 6509 microjjrocessor 

• Direct audio output 
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These i'caiurcs distingiiisli (he models: 

• Anioimt of nicmon.' ( 1 28K or 256K) 

• Monochrome lilt and swu'el monitor built in (CBM models) 

• Dual mieroproccssors. with the 16-bit 808K mieroproeessor 

bLhli in (indicated by the X in the name) 

The followincf table shows which featnres are olTered by various 
W Series eompnters; 



Model 


Memory 

(RAM) 


Standard 
Microprocessors 


Optional 
Microprocessors 


Built-in 
Monitor 


B-1 28-80 


128 


6509 


Z80,8088 


NO 


B-256-80 


256 


6509 


Z80,8088 


NO 


BX-1 28-80 


128 


6509, 8088 


ZBO- 


NO 


8X256 80 


256 


6509, 8088 


Z80- 


NO 


C8M-1 28-80 


128 


6509 


280, 8088 


YES 


CBM-256-80 


256 


6509 


Z80, 8088 


YES 


CBMX 128 80 


128 


6509, 8088 


Z80- 


YES 


CBMX-256-80 


256 


6509, 8088 


Z80- 


YES 


All of iIk-^p models 


wilf not fiecesicit 


y bp oflurfd lof sale in ¥Our 


area 





NOTE: Ypur Commodore dealer can install o Z80 microprocessor in a 
moctiine thot has ttie 8088 microprocessor built in. Only one at a time of 
tliese two microprocessors can be present in your 'B' system. 



Yon can customize vonr syslein by adding the variety of easy-lo- 
insiall peri|jherals and additional microprocessors thai arc a\-ail- 
able for the 'B' Scries roiiii>Li(ers. These peripherals include 
Commodore's Floppy Disk l)ri\es and Hard Disk Drives, a variety 
of printers for letter-quality printing or fast printing, modems for 
telecompuling. monochrome monitors for the 13 and BX ma- 
chines, and o I her devices that make your computer the ideal bus- 
iness assislant. 

The microprocessors yoLi can add to your computer include 
Commodore's Z80 microprocessor, which gives you access to 
CP/M* software. If vour'B' Scries computer doesn't have the 8088 
microprocessor built-in. you can add It yourself to gain access to 
MS DOS**. CP/M-86, and Concurrent CP/M-86*** software. 

■ CP/M lici regislpred (rciclenicirli of Digiral Research. Iiic. 
'" MS DOS IS o ircidemurk of Microsoft Inc. 
■■■ CP/M-86 tmd Concurrent CP/M-86 ore Ircidemarits of Digilol 
t?esearch Inc. 
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Chapter 4. Software, explains the eai)abilitics ol' tJiesc useful 
microprocessors. 

The new'B' Series computers [five you statc-orihe-art computer 
ca])abiliiic.s at an aflbrdable price. Commodore is comniitlcd to 
providing you wiili hardware and software that meel your needs. 
See your Commodore dealer for more information about Commo- 
dore's peripherals and software packages. 



ORGANIZATION OP THE MANUAL 

This Users Guide introduces you to the 'B' Series of Advanced 
Business Computers. The manual bef^ins by showint^you how lo 
set up your computer and by describintf optional equipment that 
expands your computer's uses. The ne.\t chapters explain how to 
use the keyboard, and how lo load and save programs. You'll al.so 
find descriptions of BASIC commands, statements, and futictions. 
and some information aboul software available for the "B' Series. 



Chapter 1 

INTRODUCTION describes Commodore's 'B' Series of Advanced 
Business Computers and presents the different fealLires of each 
machine. The introduction also shows how to use this manual. 



Chapter 2 

SETTING UP THE COMPUTER contains the instructions you 

need to unpack, conned, and install your 'B' Series computer. The 
CBM / C^BMX systems, which include built-in monitors, and the 
B/BX systems, which do not include built-in monitors, are des- 
cribed in separate sections. Chapter 2 also describes the\'ariety of 
configurations and optional equipment [peripherals] available for 
your computer. This chapter also contains a few trouble shooting 
and diagnostic procedures that can help you make adjustments to 
solve minor problems Ihat may appear after you've installed your 
com]3uter system. 
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_^ Chapter 3 

USING THE KEYBOARD describes how to use the keys on your 
compiiler's keyboard. Sjiccial keys, includinf^ the programmable 
tLuiction keys, are e.xiJlained in detail, 

~ Chapter 4 

' SOFTWARE describes how you can enhance \'oiir computer sys- 
,— ^ tern with software systems that .t^ive you access tc5 a variety of 
business, scientific, and educational software, 

— Chapter 5 

— USING YOUR DISK DRIVE tells you how to load and save both 
_ prepackaged soltware and your own custom designed programs. 

This chapter also e.xplains how to prepare new disks and how to 

— copy old ones. For additional details on the Disk Operating Sys- 
tems, consult the manuals that come with your Floppy Disk Drive 
or the fast and powerful Commodore Hard Disk Drive. 

_ Chapter 6 

EXTENDED BASIC 4.0+ COMMANDS AND STATEMENTS arc 

"^ brielly e.vi^lained. Complete formats and examples are provided. 

APPENDICES include tjuick reference inlormalion about the 
major technical features that programmers and iuany users need. 

— For an additional in-depth presentation of technical material, 
consult the Ad\'anced Business Computers Programmer's Refer- 
ence Guide. 

-. HOW TO USE THIS GUIDE: 

special Considerations 

1. As\-tni look at the edge of each i3age\'ou will notice that there 
is what we call an "inset tab," The "inset tab" shows you 

— ' exactly where the seven chapters are located. Note that the 

beginning of each chapter is a solid blue page. Both of these 
features make it easy for voli to gel to the information you 

-^ need ti nick ly. 
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2. To help you unpack, hook up. sel u|>, and begin operalin/4 
your coiiipuler. Chaplcr 2 contauis many detailed iliusira^ 
tions thai ran niakethe installalion ofyour eqtiipment. witli 
all its <)]Mi(ni.s. ac[uiek and easy (ask. 

3. U^ien we discuss a sperific kcw or wanf >'ou lo press a jjar 
ilcLiIar key. we show you a \-isual cue [Example: ■:i^iij, ii?g 
means press (he RETURN key.) 

4. Please note that this manual is not designed to teach the 
computer language BASIC (the i^rlmaiT language used in all 
Commodore computers). If you w-ant to learn BASIC language 
programming techniques, or any of the other languages 
available for use with your computerls): we suggest that you 
consult the "Bibliography" (Appendix P) for books that 
teach programming. 
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SETTING UP 
THE COMPUTER 



LJiipackinjf and I'afkiiiti 
Insiallatioii 

• 1 lookup and C'oiiritiuraiinns Availablf 

• IvxpaiidintiYodr System with IVriphci 

• Addiiional Microprocessors 

• Trouble ShootiiiLi 



Unpacking/Packing 

B and BX Computers 

The B and BX systems are shipped in one part. The package also 
contains a video cable (5-pin DIN or RCA phone-tv^^e cable] and an 
AC power cord ( 1 20 volts). 

CBM and CBMX Computer 

The CBM and CBMX systems are shi]D[jed in two parts: 

1. Base and video display screen. 

2. Keyboard with attached telephone-type cable thai phit^s into 
( he base. 

The package cilso contains an AC power cable ( 120 volts). 



NOTE: Never try to remove or disconnect the video display screen from 
the computer base. If the screen must be removed, lake the entire unit 
back to your dealer. 



Installation 



CBM and CBMX Models 

1. Make sure that your computer is turned q/fbelbre starting "~ 
installation. The CBM and CBMX computers have their — 
power switch located in the back of the machine on the left _ 
hand side. 

2. Plug the 25 PIN CABLE attached to the keyboard into the ^ 
connector on the lower right hand side of the base /video 
display unit. Make sure Uiat the Commodore Logo gJ is " 
facing up. _ 

3. Plug the 3-prong AC power cord into the power cord jack 
located in the backoCthe base /video display unit, on the left ~^ 
hand side. The power cord fits only one way. O 

4. Plug the 3 prong AC power cord into a standard wall outlet. 
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Fig. 2-) 'B' Series CBM ond CBMX (Front view) 



SETTING UP THE COMPUTER IS 




Fig. 2-2. "B' Scries B and BX iProni vi 



ont vie'Wf 
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^■^ Fig^2-3 "B" Series'Rear view) 
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B and BX Models 

Conned iht" computer to your monochrome monitor as des- 
cribed below. See Fig. 2-3 to locate each input and output on the 
bark of your H or BX computer. 

1. Make sure that your computer and your monitor are turned 
q/"/beforc startin.t^ Installation. The B and BX computers have 
(heir power switch located in the back of the machine on the 
left hand side. 

2. Attach the video cable to the computer at the connector 
labeled audio /video {5 pin DIN). Line up the pins with the 
corresponding holes and push the connector in. The cable 
will only go in one wa>'. 

3. Attach the two RCA phone-type jacks to your \1deo monitor 
inputs. See the monitor's ivjanual for instructions. 

4. Plug the computer AC power cord into a 120 voll. 60 Hz AC 
outlet. 

Your B or BX computer should now be connected properly. No 
additional connections arc required to use the computer with 

vour monitor. 



NOTE: Scjve the packing materials that your computer came in. Then, to 
pack your equipment back in the box for storage or transit, reverse the 
procedures described above. 



Eaq>aiidiiig Tour System with Per^herals 



Printers 

A full range of printers is available, designed to match any need. 
Ltnv cost, high speed dot matri.x units such as Commodore's 8023 
Tractor Printer arc ideal for most applications. Wliere letter cfual- 
ity printing is required, the Commodore "daisy-wheel" jririnter 
produces the best results. 
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Monitor 
B and 8x only 



Externol 
disk drives 



Printers 



\P 



IEEE 488 
Interfoce 



Keyboard 



B 
SERIES 



RS-232 

Port 



Printer 



Cartridge 
slot 



Program 
cartridges 




Modem 



User 
appficalion 



Fig, 2-4 Hook-up and Configuration Availoblc. Accessories ond peripherals connect to the exponsion por' 



OS shown. 



External Disk Drive Units 

Single or dual floppy disk units, with storage capacity from 
170.000 characters to over 2 million characters, can be easily 
attached to store jjrograms and data Commodore's dual floppy disk 
drives include the 8050 and the 4040. Hard disk units with 
capacities of 5 and 7.5 million characters can also be used with 
eciual ease. See vour Commodore dealer for a complete list of 
available disk drives. 



RS-232C Port 

Your computer comes equipped with an industrv'-slandard RS- 
232C serial interface. This interface provides you wit h access to a 
wide variety of peripherals, such as printers, terminals, modems, 
and data collection equipment. 

The RS-232C interface is implemented using (he fully pro- 
grammable 6551 Asynchronous Communications InterfaceAdap- 
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ler. Wish the 6551. you can ijrotiram your KS-232C' inlcrfacc to 
match exactly the reqthrenictils ofthe device vou're connecting (o 
it. 

The (extended HASIC 4.0 intcrprcler includes file le\el softwarp 
suijport for (he RS-232C- interface channel. Open (he RS-232C 
channel as you would any other file and access it wiih siandard 
BASIC' input /output stalenicnis. The RS-232C Port is device "1. 
See A]:ipendi.x N. 

CBM I£EE Port 

Your advanced computer supports the full range of Commodore 
CBM peripherals via the built-in IEEE-488 interface. Most disk 
units are "intelligent." meaning they have (heir own microproces- 
sor and memorv. You can connect up to five disk drives at one 
time toyour computer by "daisy chaining" them together through 
the IEEE-488 connector pon. 



NOTE: The device numbers that ore used with (he IEEE port must be within the 
range of 4 !o 31 inclusive. 



Additional Microprocessors and 
Operating Systems: 

Special Options to Increase Your Computer's Power 

Each computer in the "B' Series uses the 6509 microprocessor, 
which was de\'eloped by Commodores MOS Technologv' subsi 
diar>'. Commodore has designed the 'B' Series computers to be 
easily expanded to dual processor computers with the addition of 
the 16-bit 8088 microprocessor or the Z-80 microprocessor. 
These additional microprocessors give you access to hundreds of 
software packages that are independently developed for use with 
the 8088 and 2-80 microprocessors. 

In some 'B' series models, the 8088 microprocessor is built-in: 
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in Lhe others, it can be added. In addition, you caii add the Z-80 
microprocessor to any 'B' Series computer. 



The 16-Bit 8088 microprocessor: 
MS-DOS and Concurrent CP/M-86 

The 8088 microprocessor gives you access to two operating s\'s- 
tems that let you increase the software applications available for 
your 'B' Scries computer. These operating systems. MS-DOS and 
Concurrent CP/M-86. offer a variety of business and personal 
software programs. 

The 8088 microprocessor is built into four models of the 'B' 
Scries of advanced business computers. The presence of the built- 
in 8088 microprocessor is indicated by the X in the 'B' Series 
model name ((he BX-128-80, the BX-256-80. the CBMX-128-80. 
and the CBMX-256 80). These machines are dual processor 
computers. 

You can upgrade the B- 128-80. the B-256-80. the CBM- 128-80, 
and the CBM-256-80 by adding the 8088 microprocessor. If you 
have one of these systems, your Commodore dealer can install the 
8088 microprocessor for you. 



The Z-SO Microprocessor and CP/M® 
Operating System 

The Z-80 microprocessor and CP /M Operating System give you 
access to a \'arietv of CP /M software applications that you can use 
on your 'B' Series computer. These applications include: 

• widely tised bu,siness programs, such as CALCSTAR 

• word processing programs, such as WORDSTAR 

• database programs, such as INFOSTAR 

• mailing list programs, such as MAILMERGE 

• many other specialized software programs, such as high level 

computer language compilers 

The CP /M Operating System Users Guide that comes with the 
Z-80 and CP/M package explains how to operate this system. 

The Z-80 microprocessor can be installed by your Commodore 
dealer. If your 'B' Series computer Eilready has an 8088 micropro- 
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cessor, >'our Commodore dealer can remo\'e the 8088 and replace 
it with the 2-80 microprocessor. This installation is reversible: 
your Commodore dealer can switch the Z-80 and 8088 micropro- 
cessors repeatedly. This is possible lor evet^^- 'B' Series model, 
including those with the 8088 microprocessor built in. 



PROBLEM 



TROUBLE SHOOTING 

CAUSE 



1. Power indicator Computer not on 
li.q'hi not on 

Power cable not 
pugged in 



Power supply not 
plugged in 
Bad fuse in 
Computer 



2. No picture on 
video screen 



Random 
pattern on 
monitor with 
cartridge in 
place 



Incorrect hookup 



Video cable not 
plugged in 



Cartridge not 
inserted properly 



SOLUTION 



Make sure pouTr 
switch is in I he 
On position 
Check power 
socket for loose or 
disconnected 
jjower cable 
Check connection 
with wall outlet 
Take system to 
authorized dealer 
r<ir replacement of 
ftisc 



Computer 
connects to video 
and audio inputs 
on video monitor. 
Check monitor 
output cable 
connection 

Turn power off 
and then reinstert 

the cartridge 
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TROUBLE SHOOTING (cont'd.) 

'HOBLEM CAUSK SOLUTION 



Picliire with 
excess audio 
background 
noise 



Monilor volume 
setting is up too 
high 



Unvcr (he 
monitor's audio 
\'olunie control 



5. Pielurc is OK 
but you don't 
have sound 



Monilor \'nlumc 
setling is down loo 
knv 

Atixiilai^' output 
not j.iro])crl>' 
connected 



Adjust tile audio 
volume control 



Connect the 

soimcl jack to the 
aiixillaiA' input on 
your amplifier 
and then turn the 
amp. selector 
switch to (he 
"Aux. " [josition 



6. The pictLirc is 
too dark or too 
light 



Brightness le\'el is 
set Incorrectly 



Adjust the 
brightness 
control level on 
\-otir iiionitor or 
bttilt in \'idec) 
display screen 



7, Characters on 
the screen are 
hard to read 



Contrast ratio 
beiueen characters 
and background is 
too great or too 
small 



Adjust (he 
coiilrasi control 
on your monitor, 
or built-in Video 
Display Screen 
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The 'B' Series 96-key biisiness-sfyle keyboard makes a varielv ol' 
business applications easy to use. The keyboard resembles a 
typewriter keyboard, but the computer has additional keys thai 
control speeia] funcUons. You should be tamiliar with these spe- 
cial keys before you bci*in usint* the computer. 



Format Keys 



fssnnsMcmdESim 

TheliiaiUiiaand laoiail keys tell the computer to look at what 
you"\-c keyed in and put that information into menior\-. These 
keys, which have icientical functions, also move (he cursor to the 
ne.\( line. 

Wlien you key in a calculation in direct mode (i.e.. not in a 
progr am), the solution is immediately displayed when vou press 
either kl^iiiiUI or |^M±I- 

tlMAXtMJVJim 

This key lets you switch between the standard character set on 
your keyboard and the GRAPHICS mode. Wlien \'ou enter the gra- 
phics mode by pressing the EEEElHiDEEi ke\'. _\'our keyboard's 
operations undergo the [allowing changes: 

• The keys print uppercase letters onl\'. The EM41 key is not 

used. 

• The ■'iiii** key lets you print the graphics characters on the 

fronts of the keys. 

Press the EIIHicd EEEEBSIHiEl key to return to the standard 
character set of upper and lower case letters. You can't use the 
graphics characters in this NORMAL mode. 

This key works like the KlilMfl ke_v on a regular typewriter: it lets 
you print uppercase letters or the top characters on double char- 
acter keys. When you are in the NORMAL mode, the standard 
alphabet of lower and uppercase characters is displayed, and the 
■-iiii^j key gets the uppercase characters. 
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Wlien you arc in the GRAPHICS mode, howt-vcr, (lie alphabet 
apjjears i!i onK' uppercase, and the ElilUfl key geta the j^raphics 
characters on the fronts of the kevs. 

The ■-•iill^J kcv also lets you use an extra set of ten function 
keys. The ELHlcd function key is ten more than Ihe funclioii key 
you press. For example. ElUOand EI activate function key 13. 

MSBESm 

This l^ey lets you display the REVERSED imaf<e of all Ihe char- 
acters a\'ailablc on the keyboard. In olher words, characters 
appear on the screen as black on green rather than the usual 
green on black (your monitor's characters ma\- be a color olher 
than green). When you press the ■»1 J JSitt'PJ ke >-. all charact ers you 
key in appear in reverse. Press the g»]dai:t*itll key and the EIOO 
key lo turn off the reverse image display. 



Editing Keys 

The editing keys let you correct errors easily, nwvc inlorniadon 
around on the screen, and place the cursor wherever you want it. 

Cursor Control Keys: D II B H 

The cursor is the small rectangle that marks your [alace on she 
screen. The four cursorconirol keys let you move the cursor wher- 
e\'er you want it. 

The arrows on the keys show how they move the cursor: 

n Moves the cursor DOWN. 

D Moves the cursor UP, 

E9 Mo\'es the cursor LEET. 

H Moves the cursor RIGHT. 

The cursor has a repeat feature that lets it continue to move as 
long as you hold down the cursor key. 

■■-'^•-^^■■='* 

The ElBete key moves the cursor a space (o Ihe left, erasing 
the previous character you typed. Ifvou're in the middle of a line. 
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ilie cliaraclt-r lo ilie Irft is dt^lclcd aiui I lie charac-k-rs lo ilu- iMtilu 
anlomalically move lordlier (o close up ihe s|jacc. 

Y oti ran i nsert eharacters in the middle ol'lext by |)ressin{^both 
Ihe EmOaiid ihe lUOl£li9ke>'s. To use Ihe inserl f'unetion. use 
ihe cursor eoutrol keys lo mo\'e Ihe eursor to the cfiaraeler im- 
mediai ely to tlie rii^hi of where you want to insert. Hold down the 
HilUMand ■ut^wjii^ keys until there is enough space to add miss- 
iuil information. 

Like the cursor control keys, the iii'kniijM key has a repeal fea- 
ture that lets it continue I o work as lonfj; as you hold down Ihckev. 



UjIM moves, the cursor back io the upper left corner of the 
screen. This is called the HOME [)os!tion. 

You ca n move the cursor to HOME and clear the screen bv 
pressing EB3M and EESiEIIM 



Programmable Function Keys 



la IO E£i 121 la IO la IO m BEi 

The ten keys on the upper left side of the keyboard are function 
keys that let you perform a variety of repetitive tasks such as 
clearing the screen, printing a message, or pausing a program. 
The keys G| through MSUiM are predefined: 



Key 1, 


"print" 


Key 6, 


"dclose" 


Key 2, 


"list" 


Key7, 


"copy" 


Key 3, 


"dlood" + chrS (34) 


Key 8, 


"directory 


Key 4, 


' dsove" + chrS (34) 


Key9, 


"scratch" 


Key 5, 


dopen" 


Key 10, 


■chrS(" 



You can display this list by keying in: KEY 

In addition, there are ten more function keys available that arc 
not predefined. Keys 1 1 through 20 are not marked on the ke\' 
board, but you can use (hem by pressing the ELHlkev while vou 
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press OIK' of the funclion keys. The B-iill^Jt-fl rimelion key is ten 
more ilian ihe iiuniber on the key.\ou press. For e.xaiiiplc. »^'"** 
and in activate function key 15. 

^■o\^ ran redefhie (hc-se function keys with a siiopk' procedure; 
jusi follow this formal; 



KEY n,[ ]de{imilon\ . . . +[--|defm(fion["]j 1"| 

1. You imis( enter the word KEY. 

2. M is the number for the function key yoii wani to jjro.tiram ( 1 
through 20). Be sure In include the comma. 

3. de\\n\\\on defines what you want the function key (o do. 



1 lere are some examples; 

KEY 9, CHRS (142) 

KEY 15, XHRSlU) + 
CHR$(13) + CHRS(77)' 

KEY 1, 

■ 0PEN4,4:CMD4:L1ST: 

CL05E4- + CHR$(13) 



Automatically switches to graphics 
mode. 

Autoinalically swilehcs (o nor.;ial mode, 
advances to next line, and prints M. 



Lists program on printer. 



Funciion kevs retain your detinition only during* the cm-rent 
session al the computer. Once you turn the compuier off. your 
definitions are kist for all function keys, unless you save these 
definitions in a program. 

The liiiilS key lets you print the graphics characters on the 
fronts of the non alphabetic keys (e.g.. number keys, punctuation 
kevs. etc.) These graphics keys are displayed in either Gl^I'HICS 
or NORMAL inotic. 'fhe alphabetic keys' graphics are displayed by 
using the Edillii key in GRAPHICS mode only. 

The ■***:!■ key lets you use special control functions. To use a 
conirol finiction. hold down the EEHkey white you press the key 
that gives vou the function you want. Here are some examples: 
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SCREEN 
EDITOR 
FUNCTION CODE MEANING 

Set CTRL-B Set the bottom right boundary for the screen 

Window window to the current cursor position 

Bottom 



Delete CTRL-D Delete the current line and scroll up all lines 

Line below the current line to replace the current line. 

Blank lines are inserted at the bottom of the 

screen. The cursor is positioned at the beginning 

of the new line, 

Bell CTRL-GToggle the end of line bell. IF the bell rings, then 
the end of line bell is enabled. If not, the end of 
line bell is disabled. 

Insert CTi^L-l Insert a blank line offer the line on which the 
Line cursor is currently positioned. Place the cursor at 
the beginn ing of the blank line. 

Erase To CTRL-P Delete all text from the cursor position to the end 
Line End of the line. Replace all deleted text with blank 
characters (spaces). 

Erase CTRL-Q Delete oil text from the beginning of the line to 
From Line the cursor position. Replace all deleted text with 

Start blank chgrocters (spaces). 

Set CTRL-T Set the top left boundary for the screen win- 

Window dow to the current cursor position. 

Top 



Thi.s key is used in conjunction with anvof the 26 alphabet keys 
through Q to perforni a variety of special I'unction.s. To per- 
Ibrni any iuncLion listed below, press theiaaakcy. release it. and 
press the appropriate letter. 



Automatic insert 

Set bottom rij^ht corner of window 
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Cancel aulonialic insert 
Delete line 
Nonflashin,ti cnrsor 
Plashing cursor 
Enable (turn on) bell 
Disable (turn oftl bell 
n Insert line 

n Move to the Stan of the line 
Q Move to the end of the line 
n Enable scrolling 
CI Disable scrolling 
d Normal screen 

Cancel insert, quote and reverse modes 
Erase to the start of the line 
Erase to the end ol' the tine 
Re\'erse screen 
Solid cursor 

Set the top left corner of window 
Underscore cursor 
-— N D Scroll up 

121 Scroll down 

D Cancel escape sequence 
■ — ■ D Normal character sel 

D Alternate character set (not currently implemented} 

Quote and Insert Modes 

~ When you press the quote key (') once, you enter QUOTE MODE: 

— when you press the ICS key, you enter INSERT MODE. In these 
modes, control and cursor keys are dis])layed rather than exe- 
cuted. Quote mode is cancelled when you press a second quote, 

.— , Insert mode ends when the nimiber of characters you entered 

equals the nvunber of spaces you opened up with the INS key. For 

■~ e.xample, if you press the U^^l key si.x times, insert mode ends 

— when you have entered six characters. 

In addition, ifyour machine is in quote or insert mode, the 1^3 

■ ■ key cancels the mode and returns you to normal (text) mode. 

When you are in a mode other than normal mode, you must press 

the |£i*| key t\\'ice to use any of the |£l!l ke\- special functions. 

— \ 

^■^ ■ Cctncei these two functions by pressing Ihe Bi^Sly^Jkey twice. 
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Y oLi can halt a BASIC program whilr it is running bv [jrcssing 
the B^lkey. Yoii can also use (his key to halt a print oul. 

The Ena key lets you auloiiialically load the first program on a 
diskct I c (drive 0). Just press theEUHland EQEIkevs to use (his 
fuiielion. 



The 13 key slops a [orograiii IVom eoni inning loseroll down the 
sereen. This key is used mos( ollen when you are iisilng a pro- 
gram and you want to slop lo view part of the program. Press any 
key (o restart the scrolling. 



Calcidator Pad Keys 

The calculator keypad on the right side oiyour keyboard offers all 
the standard calculator fLniclions. This keypad lets you perforin 
calcnlai icons cjuiekly and conveniently. The keyjjad is not affecled 
when you enler special modes such as the graphics mode. 

H guestion Mark 

The f|uestion mark is the slandard abbreviation for the PRINT 
statement in HASIC. To execute a calculation on a compuler, von 
niusl precede the calculation with a PRINT stalemeni or a ques- 
tion mark. The question mark had been placed on the keypad for 
your con\enience. 

For example; 

?23.45'.06 
1.407 



The number keys are arranged like a regular calculator. We have 
included a double zero Elil for voiir convenience. All numbers 
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located at the top of the main keyboard section can be used in 
calculations when your computer is operating in the unshifted, 
normal mode. The ke\pad numbers work in any mode. 

■ Decimal Point 

This sen,'es as a decimal point for lloating point compulations. 
The period, located at the bottom right section of the main key- 
board, also works as a decimal point in the unshifted, normal 
mode. 

D Slash Key 

The slash key operates as a symbol for division. The slash key 
located at ihe boKom ri.ght seel ion of tlie main keyboard also 
works as a division symbol, but only when you are in the 
unshil'ted. normal mode. 

D Minus Sign 

This key operates as a symbol for sutat raclion. II also operates as 

the unan' minus symbol, which is the minus sign preceding nega- 
tive numbers. The minus sign key located at Ihe top right section 
of the main keyboard elIso works as the .symbol for subtraction 
and nnaiA' minus in the luishifled. normal mode. 



I Clear/Entry 

This key resembles the Clear Entr>' key found on mo st ca lcula- 
tors. Use this key to eliminate the last number entered. I!ia clears 
the last numberofacompLitation line, back lo the l ast a rithmetic 
operator. If the last entiT is an arithmetic operator. I^c-learslhe 
operator. If the enti^- is not numeric, ES works like l!ic | 'H1=1 I =1 
ke\'. 

For c.\am[jle: 

10 PRINT 45*96 + 9.8/52 + 31 
If you press the EM key once, the line looks like this: 

10 PRINT 45*96 + 9,8/52 + 
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Press once more: 

10 PRINT 45-96 + 9.8/52 
Press twice more: 

10 PRINT 45-96 + 9.8 
Press once more: 

10 PRINT 45'96 + 
Press fh'e limes more: 

10 PRIN 

HMultiplicalion 

This operates as a symbol for muUiplication. You can't use the 
conventional X because the computer can't disiint^uisli the let 
ter X from the multiplication sign. You can also lisc the Hkev on 
the main keyboard when you are in the unshifted. normal mode. 

ElPlus Sign 

This operates as a symbol for addition. It also serx'es as the 
unan,' plus symbol to represent positive numbers. Unan' plus is 
automatically assumed by the computer, however, and is not 
necessaw. You can also use the plus sign key on the main key- 
board when you are in the Linshifted. normal mode. 

Exponentiation 

Use the Lip arrow (a ESISBed 61 to raise a number to a power. 
For example: 

?12 I 5 
248832 

Execution Order In Calculations 

The computer performs multiple calculations in a certain order. 
Problems are solved from left to right, but within that general 
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movcnictil. some' types of'calculalioiis lake precedence over others. 
The order of precedence follows these guidelines: 

First B unaiT minus (minus sitin for negative num 

bers. not for subtraction) 
Second || exiKincntiation. left to right 

Third HD multiplication and division, left to right 

Fourth BIB addition and subtraction, left to right 

This means that the computer checks the whole calculation for 
negative numbers before doing anything else. Then it looks lor 
exponenis; then it pcrform.s all multiplication and division; then it 
adds and subtracts. For example: 

?33 + n /4 
35.75 

In this example. 1 1 is divided by 4 and the result is added to 33, 
To override the order of precedence, enclose any calculations you 
wan! solved first in parentheses. All parenthetical calculations are 
soh'cd before any other calculations. U^en more than one calcula- 
tion is enclosed in parentheses, these calculations are solved left 
to right. Within parentheses, calculations are solved according to 
the order of precedence. If you add parentheses to the previous 
cxamjile. here's what happens: 

?(33 + 11)/ 4 
11 

When you have more than one calculation within parentheses, 
you can further control the order by using parentheses within 
parentheses. The problem in the innermost parentheses is solved 
first. For example: 

?30 + (15 ■ (2 ^ 3)) 
15 
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CoiiTinodore software available for your computer will cover a 
broad range of business and personal applications. These pro- 
grams include word processing packages, database prr)grams. and 
a variety of financial applications, such as spread sheet programs 
and accounting packages. Easy-to-use software will also be avail- 
able for a variety of professional fields including medicine, law. 
agriculture, construction, and restaurant management. 

Data processing professionals will be able to purchase develop 
mental tools such as assembler software to facilitate machine lang- 
uage le\'el programming. A BASIC compiler will also be available. 
This program permits compilation of BASIC programs into highly 
efficient machine language. 

The 16-bit 8088 Microprocessor 

The 8088 microprocessor gives you access to two widely-used 
operating systems. MS-DOS* and Concurrent CP/M*Tand to the 
x'ariety of software products these systems support. 

Hie 8088 microprocessor is built into the X Series of advanced 
business machines (the BX- 128-80. BX-256-80. CBMX- 1 28 80. 
and the CBMX-256-801. and it can be added to all (he other "B' 
Series models, so the variety of software products the 8088 sup- 
ports can be ax'ailable to you. 

The Z-SO Microprocessor and the CP/M Operating System 

The Z-80 microprocessor lets you use the popular CP /M Oper- 
ating System, which offers many prepackaged software programs. 
These programs include widely used business applications, word 
processing packages, high level language compilers, and more. 
With the CP/M Operating System, you can use many popular 
software packages, such as the wordprocessor WORDSTAR, the 
address manager MAILMERGE, database programs such as 
INFOSTAR. and many other best-seller industry standards, 

The Commodore Software Division 

The Commodore Software Division is working with software 
publishers to develop a high quality librarv' of software products 
that will nil your computing needs. Products not already on the 

' MS DOS ii a tiadenicirk of Miciosofl, Inc. 
" ConcufTent CP/M is o traclenicirk oi Digital Research, Inc 
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market will be available soon from your local Commodore dccder. 
Your dealer has more information about Commodore software, 
— ■ and can keep von informed of the arrival of new software 
products. 
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CHAPTER 



USING YOUR 
DISK DRIVE 



Cdniiec'iinC Vdur Disk Drive 

Loadine Prepackaged Protiranis from Diskette 

PreparinCXew Diskettes: HEADER Command 

• Uiadin.ii VniirOwn t'roarams lr(im Diskette 

• Sa\1im Prntiranis on Diskette 

• C'opyiii.t* Diskettes: BACKUP Command 



CONNECTING YOUR DISK DRIVE 

Your computer supports the full range of Commodore CBM 
peripheral devices via the built-in IEEE-488 interface. Most 
Commodore disk units are intelligent, which means that they 
have iheir own microprocessor and memor\'. so (hey don't take up 
memory- from your computer. 

Your disk drive is easy to install; 



1. Attach the PET-to-IEEE cable to (he IEEE port on the back of 
the disk drive (see diagram). 

2. Plug the other end of the cable into the IEEE port on the back 
of the computer. The Commodore logo faces up. 

3. Make sure the plugs are .securely attached. 



*_/ 



Ifyou are also attaching a printer, plug the cables into the disk 
drive first, then attach the computer and the printer. You can 
connect up to five disk drive units at one time to your computer by 
daisy chaining them together. When you attach more than one 
cable to the disk drive, just plug the additional cables into the first 
cable (see diagram). Make sure the plugs are secure. 



L-^ 
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Fig. 5-1 Daisy chained peripherals 
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Turn on ihe machines' power: all power lights on aJI your dev- 
ices should be ON. 

The manual ihal comes with your disk drive contains more 
information. 



NOTE: Never turn your disk drive OFF when there ore disl<s in ony drive. 
Always remove disks first. If the drive is turned off with disks in place, 
remove them before turning the drive bock on. 



Most prepackaged software includes special commands that 
show you how to load, save, and retrieve programs using your 
disk drive. 



Loading Prepackaged Programs from Diskette 

~ 1. Siart by carefully inserting the preprogrammed disk into 
>— . drive zero (0). 



NOTE: The computer will always assume that you're putting your disk into 
drive zero (0) and that you're using disk drive unit number eight [8;. These 
ore known as "default values." If you want to use another drive or unit 
number you must use the optional codes shown in Chopter 6 in square 
brackets I -l.j. 



2. Make sure that ihe label on the disk is facing up and is 

closest to you. 
"^ 3. Look for a little notch on the disk (it might be covered with a 
__^ small strip of tape). If you're inserting the disk properly the 

iiotch will be on the left side. 
— ■ 4. Close the door on the disk dri\'e to secure the diskette. 
5. Key in: 

DLOAD "program name" 
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a Press the Emma key. 

The disk will make noise and the busy light wiil turn on. Your 
screen will say: 

SEARCHING FOR 0: program name 

LOADING 

READY 

7. Wail until the READY message comes on and the cursor 
appears; tlien key in: 

RUN 

8. Press the ■:i^uisi:f key and your prepackaged software is 
ready to use. 



Preparing Nor Diskettes: HEADER Command 

Before you can use a new disk for the first time, you must for- 
mat it with the HEADER command. This command divides the 
disk into sections called blocks, and it formats a tabic of contents, 
called a directon,' or catalog', for the disk. You can also reuse a disk 
by erasing all stored data with the HEADER command. 

Follow these steps: 

1. Insert the disk in drive 0. Remember to handle the disk care 
fully. Put the disk in so the label side is up and the small 
notch is on the left side as you face the drive unit. The side 
with the oval exposed area should go in first. 

2. Close the disk drives protective gate to secure the disk. 

3. Key in: 

HEADER "diskname", Ds (,lnn) (,ON Un) 

diskriame is any name for the disk. For example, MYDISK. 

MEMOS. PAYRECS. etc. 

Ds identifies the drive nimiber (0 or 1 ). 
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nn is a 2 characier idcnt il'icat ion luiinbcr for i he diskctic. The 
id number should be unique for each disk. 
-^ n ideniil'ies the drive unii if you have more than one. 

4. Press the t jj^niiiiJJ key and wait until the computer displays 
this messaf^c: 

_ ARE YOU SURE? 

~^ 5. Respond by keying in: Y (for Ycsl and ■H=1i""i'^ 

The disk drive makes a noise while the new diskette is being 
— headered. This process takes a few minutes. The computer will 
display a READY message when the diskette is finished. 



NOTE: THe HEADER command erases any informotion stored on a diskette 
and you will not be able to retrieve it. Use this command carefully. 



Here are some examples of the HEADER command: 

HEADER ■■LETTERS", Dl , 104 Formats a diskette named LET- 
TERS in drive 1 and. gives it the id 
number 04. 

HEADER ■NOTES', DO, 124, 

ON U9 Formats a diskette names NOTES 

in drive of drive unit number 9 
The id number is 24. 



Loading Tour Own Programs From Diskette 

Loading a program from diskette is simple and takes only a few 
seconds. Once a program is loaded, you can RUN it. LIST it, or 
make changes and save the new version. Follow these steps to load 
a program: 

L Kcv in: 



DLOAD 'program name' 
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NOTE: You can load the firsi program on o diskeHe by using * instead of the 
program name. For example; DLOAD """ 
Youcan L OAD tlie firsf program from a diskette in drive bv Dressina a 



2. Press the ■:i=tni;i« key and wait for [his message to be dis- 
played on your screen: 

SEARCHING FOR 0; program nome 

LOADING 

READY 



NOTE: When you load a new progrom into the computer's memory, ony 
unsaved instructions and programs in memory are erased. Be sure you 
SAVE any information you want to keep before you key In DLOAD. 



Here are some examples of the DLOAD command: 

DLOAD ■ WORDCRAFT" Loads the program named WORD- 

CFIAFT into mcmon*. 

DLOAD ■■"■ Loads the first program on the disk- 

ette, regardless of its name. 



Saving Programs On Diskette 

Follow these simple steps to save a BASIC program on diskette: 

1. Key in: 

DSAVE ■progrom name'" 

2. Press ^Sniaa and wait for this message: 

SAVING 0: program name 

OK 

READY 
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NOTE: When you change a saved program and want to repiace the old 
version, odd the <9> sign before the program name. For example, DSAVE 
"@OLDPROG'" saves the new version of OLDPROG and erases the original 
version of the program. If you want to keep both versions, use on 
original name for Ihe changed version. 



Copying Diskettes: BACKUP Command 

You should keep an extra copy ofyour stored programs for your 
protection. Follow these simple steps to make a backup copy of a 
diskette: 

1. In.sert a blank disk into drive 1. Inscn Ihc master disk into 
dri\'e 0. Key in: 

BACKUP DsTO Dc/(,ONUn) 

s is the drive number ol' the source drive (i.e.. the diskette you 

\van( to copy): 
d is the dri\e number of the destination drive (i.e.. the blank 

diskette you're copying on to): 
n is the disk drive unit number if you have more than one drive 

unit connected to your system. ON Uz is an optional part of 

this command. Omil it if you have only one disk drive iiiiii 

in operation. 

2. Press EHEEEIand wait for this message: 

READY 



NOTE: Backing up tokes a minute or so, but the READY message appears 
before the process is complete. You can find out when the backup is com- 
plete and be sure that it wos successful by keying in PRtNT DS5. DSS is a 
reserved word variable that disploys a diagnostic message about disk sta- 
tus, including on error message if an error occurred during a backup. 

If DSS tells you the backup was successful (00,OK,00,00,0) you can list a 
directory of files on the disk: CATALOG iDn) (On Uz). Here, n is Jhe drive 
number of the disk onto which yoy just copied. This part of the commond is 
required unless you have only a single disk drive. Otherwise, you must nome 
the drive. ON Uz is required when you have more than one disk drive unit. 
The z names the drive unit where the computer can find the disk whose 
contents you ^vish to display. 
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Here are some examples of (he BACKUP command; 

BACKUP DO TO Dl Use when you have one dual disk 

drive and you are copying from 
drive to drive 1. 

BACKUP DO TO Dl ,ON U9 Use when you have more than one 

disk drive imit and you are copying 
from drive to drive 1 on drive 
unit 9. 
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CHAPTER 



EXTENDED 

BASIC 4.0+ 

COMMANDS AND 

STATEMENTS 



Conventions in Formats 

• Using BASIC Commands 

• Using Basic Statements 



This chapter provides formats, brief explanations and examples 
of the BASIC 4.0 commands and statements. It is not intended to 
teach BASIC. Appendix P lists tuloriaJ books that help vou learn 
BASIC. 

This chapter lists commands and statements in separate sec- 
tions. Within the sections, (he commands and statements arc 
listed in aJphabetical order. In most cases, commands can be used 
as statements in a program if you prefix them with a line number 
You can use many statements as conmiands by issuing them in 
direct mode (i.e.. without line numbers). 



CONVENTIONS IN FORMATS 

The following conventions are used in the formats of the BASIC 
commands and statements: 



• KEYWORDS, also called RESERVED WORDS, appear in 
uppercase letters. YOU MUST liNTER THESE KEYWORDS 
EXACTLY AS THEY APPEAR. However, many Rewords have 
abbreviations that you can also use (see Appendix B). 

Kev-words are words that are part of the BASIC language, 
and that your computer knows. Kev-^vords are the central part 
of a command or statement. They tell the computer what 
kind of action you want ii to take. These words cannot be 
used as part of your filenames or other variable names unless 
they are enclosed in quotation marks. However, we recom- 
mend that you NOT use keyu'ords Ibr variable names. 



• ARGUMENTS, also called parameters, appear in lowercase 
letters. Arguments are the parts of a command or statement 
that you select: they complement keywords bv providing spe- 
cific Information about the command or statement. For 
example, a keyword tells the computer to load a program, 
while an argument tells the computer which specific pro- 
gram to load and in which drive the disk containing the 
program is located. Arguments include filenames, variables, 
line numbers, etc. 
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• SQUARE BRACKETTS ([]) show OPTIONAL arguments. You 
select any or none of the arguments listed, depending on your 
requirements. 



• ANGLE BRACKETS (< > ) indicate that you MUST choose 
one of the arguments hsted. 

• VERTICAL BAR ( 1 ) separates items in a list of arguments 
when your choices are limited to those arguments listed, and 
you can't use any other arguments. Wien the vertical bar 
appears in a list enclosed in SQUARE BRACKETS, your choi- 
ces are limited to the items in (he list, but you still have the 
option not to use any arguments. 

• ELLIPSIS (...) a sequence of three dots, means that an 
option or argument can be repeated more than once. 

• QUOTATION MARKS (" ") enclose character strings, file 
names, and other expressions. Wlien arguments are enclosed 
in quotation marks in a format, you must include the quota- 
lion marks in your command statement. Quotation marks 
are not conventions used lo describe formats; they are 
required pEirts of a command or statement. 

• PARENTHESES. When argimients are enclosed in paren- 
theses in a format, you must include the parentheses in your 
command or statement. Parentheses are not conventions 
used to describe formats: they are required parts of a com- 
mand or statement. 



• VARIABLE means any valid BASIC variable name, such as 

X. AS. or T%. 

• EXPRESSION means any valid BASIC expression, such as 

A + B + 2or.5*[X + 3). 
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BASIC COMMANDS 



BACKUP 

This command copies all the files on a diskette to another 
diskette. You can copy onto a new diskette without first using the 
HEADER command to format Ihe new diskette because BACKUP 
aJso formats diskettes. You should always backup disks in case 
the ori,0nal is lost or dajnaged. 



NOTE: BeCQuse the BACKUP command also headers diskettes, it destroys 
ony informotion already stored on the diskette onto which you are copying 
information. Therefore, be careful when you use this command. If you're 
copying onto an old diskette, be sure it doesn't contain any progroms you 
wish to keep. See also the COPY command. 



BACKUP DsTO Dd[ONUn] 

s is the number of the source drive (i.e.. the drive containing the 
disk whose files you want to copy). 

d is the number of the destination drive (i.e.. the drive contain- 
ing the disk onto which you want to copy). 

n is the number of the disk drive unit. Use this argument only if 
you have more than one unit connected to your system. 

Examples: 

BACKUP DO TO Dl Copies all the files from the disk in 

drive to the disk in drive 1. 

BACKUP DO TO Dl , ON U9 Copies all files from drive to drive 

1 in disk drive unit 9. 

CATAIX>G 

This command displays the names of all Ihe files on a diskette. 
The catalog of files is also called the director^'. 

CATALOG [■■filename"] [Ds] [ON Un] 

s is the number of the drive containing the disk whose directory 
of filenames you want to display. 
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n is Ihciuinibcrofthedisk drive unit. Use Ihisai-gumenl only if 
voii have more than one disk drive. 



Examples: 

CATALOG Dl 
CATALOG DO, ON U9 

cA ABC- ,D0 



Displays a directoiy of all files on 
the disk in drive 1. 
Displays a direcfoiy of all files on 
the disk in drive of drive unit 9 
(use when the drive unil number is 
not 8). 

Displays all directors- files that be- 
gin with ABC. cA is the abbre\'ia- 
tion for CATALOG. Appendix B lists 
other BASIC keyword abbrevi- 
ations. 



COLLECT 

Use this command to search the files in your directory- for 
improperly closed files. COLLECT frees up space allocated to 
improperly closed files and deletes their references from the 
directory. 

COLLECT [Dsj [ON Un] 

.s is the mniiber of the drive containing the diskette whose files 
you wani to COLLECT. 

n is (he number of the drive unit. Use this only when you have 
more than one drive tmit in operation. 



Examples: 

COLLECT 
COLLECT Dl 
COLLECT DO, ON U12 



Searches files on the last drive 

accessed. 

Searches the files on the diskette in 

drive 1. 

Searches the files on the diskette in 

drive of drive unit 12. 
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CONCAT 

Merges (concatenates) two sequential data files. \Vlien you con- 
catenate fiies. the second file in your command is deleted and 
replaced by a new file which is the concatenation of the two files. 
The first file in your CONCAT command remains unaltered. 

CONCAT [Ds] sourcefi/e" TO [Dd] " destfile" [ON Un] 

s is the drive number of the disk drive containin/^ (he file you 

want to add to another file. 

"sourcefile" is the name of that file which is appended to the 

"desiii^ation file", and which remains unaltered. 

d is the drive number of the disk drive containing the file to 

which you want to append the "sourcefile". 

"deslfile" \s the name of the destination file, which receives the 

sourcefile and becomes a combination of the two files. 

n is the number of the drive unit. Use this only when you have 

more than one disk drive unit. 



Examples: 



CONCAT MYFILE- TO -YOURFILE'' 



CONCAT 
■MSFILE', 



INDEX TO 
ON U9 



Merges MYFILE and 
YOUF^FILE. YOURFILE 
becomes YOURFILE 
+ MYFILE. 

Merges INDEX and MSFILE 
on disk drive Linit 9. 
MSFILE becomes MSFILE 
+ INDEX. 



CONT 

This command restarts the execution of a program that has 
been interrupted by a STOP or END statement in a program, or 
when you have pressed the STOP key. Execution resumes at the 
point where I he break in the program occurred. If the break 
occurred after a prompt from an INPUT statement, execution con 
tinues by reprinting the prompt. 
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CONT is generally used in conjunction with STOP for dcbug- 
ging. When you stop execution, you may examine and change the 

^^ values of \'anables (e.g.. B = 200) and issue commands in direct 
mode, sucli as PRINT B. You can then resume execution with 

"" CONT or with a direct mode GOTO, which restarts at a specified 

_ line number. However, the changes you can make during a break 
are limited: if you edit any line of your program during a break. 

~ you can"! use CONT to restart the program. 

"^ CONT 
Example: 



RUN 

?7.9 

7.9 

4 

.0999999996 

-3.8 

BREAK IN 10 

READY 

LIST 

10 INPUT A 

20 X = X - B 

30 B = 3.9 

35 PRINT X + 

40 GOTO 10 

READY 

B = 3.6 

READY 
CONT 

- 7.4 

- 11.3 



Program begins executing. 



STOP ke>' pressed. 
Break in execution. 

You can LIST a program 
during a break and still 
use CONT to resume. 



You can chcuige the value 
of a variable IF you do 
this in DIRECT MODE. 
Key in CONT to restart 
execution. 



COPY 

This command copies files from one diskette to another. Unlike 
the BACKUP coinmand. which erases all information on the disk 
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that receives the transfer, COPY does not affect what is already on 

the destination disk. In addition. COPY letsyou transferjust some 
of the files on a disk while BACKUP transfers the entire contents 
of the source disk. 

COPY [Ds,] [ sourceWe") TO [Dd,J \-destfile-] [ON Un] 

s is the drive number of t he disk whose file is being copied. 
"sourcejile" is the name of the file being copied. 
d is the drive number of the disk that will receive the trans- 
ferred file. 

"destfile" is the name of the file that is the destination of the 
transferred file. 

n is the unit numiber of the disk drive. Use onlv when the 
number is not 8 (the default value). 

Examples: 

COPY DO, ■■FILE4" TO Dl , TESTS" Copies the file named FILE4 

from the disk in drive to the 
file named TESTS in drive 1. 
Only that file is copied, and 
all data stored on D 1 remains 
unaffected. 

COPY DO TO Dl Copies all files on drive to 

drive 1 without deleting any 
files already' on drive 1. 



DCLEAR 

This command initializes one or more disk drives. The com- 
mand defaults to drive if you don't name a drive number. 

DCLEAR [Ds] [ON UnJ 

s is the number of the drive you want to initialize. 

n is the unit number of the drive. U,se if the number isn't 8. 



Examples: 
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DCLEAR 
DCLEAR Dl 



Initializes drive 0. 
Inilializes drive 1. 



DELErr£ 

This command erases from memorv' a line or group of lines from 
the BASIC program currently in memory: 



Erases the entire program current- 
ly in memory. 

Erases alt lines from the line nuim- 
ber named to the end of the pro- 
gram. 

Erases all lines from the start of 
thepn)gi-cU7i to the line number named 
DELETE imenumber-Hnenumber Erases all lines between and includ- 
ing the line numbers named. 



DELETE 

DELETE linenumber- 

DELETE -linenumber 



DELETE j/menumber] 
E.xamples: 
DELETE -50 

DELETE 50- 



[I'menumber 



Erases all lines of the current pro- 
gram from the first line through 
Ime 50. 

Erases all lines of the current pro- 
gram from line 50 to the last line. 



DIRECTORY 

This command displays the names of the files on your diskette. 
If you list a filename or a prefix common to more than one file- 
name, only those files are displayed. For example, all sequential 
files named SEQFILE can be listed, or you can list all filenames 
beginning with a common prefix by placing an * after the prefix 
(e.g.. '"WORD*" would list files including WORDPRO, WORDCRAFT, 
WORDLIST. etc.). If you use (he ON U argument to name a drive 
unit and do not specify a disk drive number, the directories of 
both drives are displayed. 
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DIRECTORY [Ds] {;■ filename'] [ON Un] 

s is the number of (he drive eonlainhitJ ihe disk whose contents 

you want to display. 

"filename" is ihe name of a I'ile or files with the same prefix that 

you wish to list. 

n is the unit number of the disk drive. Use if the number is not 

8, which is the default value. 

E.xamples: 

DIRECTORY Dl Displays a list of all the filenames 

in drive 1. 

DIRECTORY Dl -INTRO" Displays a list of all files named 

INTRO in drive 1. 

DIRECTORY ON U9 Displays a list off all the filenames 

in both drives on dri\'e unit 9. 

DIRECTORY DO, 'ABC ' Displays all directoiy files that be- 

gin with "ABC' on drive 0. 

DLOAD 

Brings into memory a BASIC program that is stored on disk. 
You follow the same procedure to load a [Drej^ackaged program and 
a program you wrote and saved yoLirself You can use DLOA13 as a 
statement in the body of a program to chain other programs on 
the same diskette. This automatically rims the program in the 
DLOAD statement. 

DLOAD ■filename" [,Ds| [ON Un] 

"filename" is the name of the file you want the load. 

s is the number of the drive whose disk contains the file (the 

default is 0). 

n is the number of the drive unit. Use only if this number is not 

8. which is the default value. 

Examples: 

DLOAD "OLDFILE' Loads a file named OLDFILE from 

drive into memon,'. 
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DLOAD 'XFILE ■, Dl,ON U13 Loads XFILE from drive 1 of drive 

unil 13 into memorv. 



~ DSAVE 

"^ This command stores a BASIC program on disk. The filename 

can be up to 16 characters long. If you use a variable or an e\'alu- 

ated expression as a filename, enclose it in parentheses. 

__ DSAVE 'fi/enome ■ l,Dsi [ON Un] 

"filename" is the name of the file you u^ant to save, 
, s is the number of the drive containing the disk on which you 

want to store a file. The default is 0, 
■ n is the number of the drive unit. Use only if this number is not 
8, which is the delault value. 

'~^ Examples: 

"" DSAVE BASFILE" Saves the file BASFILE to drive 0, 

— DSAVE -FILETl ",D1 Saves the file FILETl to drive 1. 



— HEADER 

Before you can use a new diskette for the first time, you must 

format it with the HEADER command. This command divides the 

disk into sections called blocks, and it formats a table of contents. 

— ■ called a directory or catalog, lor the disk. You can also reuse a disk 

because the HEADER command erases all stored data. 

See Preparing New Diskettes: HEADER Command, in Chapter 5 

— for more inibrmation, 

~ HEADER -'dhkname'. Ds [,lnn] [ON Un] 

"diskname" is the name you give lo (he diskette, 

s is the number of the drive containing the disk vou want to 

— HEADER 

nn is the 2 character identification number for the diskette, 

n is the number for the drive Luiit. Use only ifthe unit number is 
not 8. which is the default value. 
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Examples: 

HEADER -MEYERDISK', D1J28 



HEADER "SCMFILE",D0J07,ON U9 



Headers a disk in drive 

1. ftivint^ it llie name 

MEYERDISK 

and the id number 28 

Headers a disk in drive 
0. of unit 9. naming it 
SCMFILE with the id 
number 07. 



KEY 

This command displays a list of the current definitions of the 
function keys and lets you define these keys. Recall that keys Fl 
throu,£jh FIO are predefined, but that you can redefine them. Any 
definition you |*ive is erased at the end of the current session, 
whether it is a redel'inition of an Fl through E'-IO key or a defini- 
tion of an Fl 1 through F20 key. 

To define a function key. follow these steps: 

1. Key in the word KEY and the number of the key you want to 
define, followed b\' a comma. For example: 

KEY 15, 

2. Enter the definition for the key. If you want to print the 
definition before you execute the function, enclose the defini- 
tion in quotation marks. To use the function, press the key 
and then press ■:iaiii:i:i to execute. If you don't enclose the 
definition in quotation marks, the function is executed 
immediately when you press the function key. If you want the 
function to do more than one operation, string the opera- 
tions together with plus signs. For example: 

KEY 15;PR1NT + CHR$(142)" 

This switches the keyboard to graphics mode. 
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KEY [keynumber, "c/efinif/on [ + definition... + definition] 



Examples: 

KEY5,CHR$(34) 

KEY 17, 
PRINT CHRS(142) + 
CHRS(771 + CHRS(13) 
+ CHRS(651 



PRINTS a (juolalion mark im- 
mediaiely when you press Key 5. 



Wlien you press Key 17. the 
text of what the key does is dis- 
played without quotation 
marks. Cursor remains at the 
end ol' the line until you press 
■;i^ni;i« to execute the func- 
tioii. 'ihis I'linction docs four 
things; 

1. switches to graphics mode 

2. PRINTS an M 

3. activates ESnOa key 

4. PRINTS ail A 



LIST 

This command displays a listing of all or part of the program 
currently in memory. After a LIST command executes. BASIC 
always returns to the direct mode, also called the command level. 



LIST 

LIST linenumber- 



LIST-linenumber 



. — . LIST Itnenumber-linenumber 



Lists the entire program. 
Lists all lines from the line 
number named to the end of 
the program. 

Lists all the lines from the 
beginning of the program to 
the line number named. 
Lists all the lines between 
and including the numbers 
named. 



LIST [[linenumber] {-] [linenumber] 
Examples: 
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LIST Lists all the lines in the cur- 

rent program. 

LI5T-50 Lists the lines from the begin- 

ning lo line 50. 



LOAD 

This command brings into memor>' a program stored on disk- 
ette. LOAF) closes all oix-n files and deletes all variables and pro- 
gram lines currently in memory, so be sure to save anything you 
want to keep before you issue the LOAD command. 

You can use LOAD as a statement in a program to chain se\'eral 
programs. If you execute a LOAD statement from one program, the 
loaded program is RUN after it is LOADed. and all data files are 
kept open. None of the variables is cleared during a chain 
operation. 

LOAD ■■\Ds:]filenome".DevU 

s is the drive number containing the disk from which the pro- 
gram will be loaded. The default is 0. 

"filename" is the name of the file you want to load into memory. 
Dev^ is the device number of the disk drive containing the file 
you want to load. The disk drive device number is 8 unless you 
change it. 

Examples: 

LOAD ''.S Loads (he first file on the disk in 

drive 0. 

LOAD ■ MEYERFILE ,8 Loads the file MEYERFILE from 

drive into memory. 

LOAD liSCMFILE'^S Loads SCMFILE from drive 1 into 

memoiy. 

LOAD ■1:MY* ,8 Loads first file in drive 1 that beg- 

ins with the letters MY. 

NEW 

New erases the BASIC program and dala currently in memorv 
so that a new program can be entered. Be sure to save anything 
you wan! to keep before you issue a NEW command. 
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YoLi should always use the NEW command before you enter a 
new program to be sure that memoiy is clear, otherwise unwanted 
lines from the pre\'ious program could merge with your new 
program. 

NEW 



„ RENAME 

, This command changes the name of a file on a diskette without 

altering the file itself You cannot execute a RENAME command 
on a currently open file. 

RENAME [Ds, I 'oldname' TO "newname" [,ON Un| 

, s is the number of the disk drive containing the file vou want to 

RENAME. The default is 0. 

"oldname" is the current name of the file. 
. . "neivname" is the name to want to use. 

n is the unit number. Use only if this number is not 8. which is 

the default value. 



Examples: 
_ RENAME Dl, -HERFILE- TO ' MYFILE' 

„ RENAME'DRAFT- TO- BOOKFILE" 



Gives the new name 
MYFILE to HERFILE on 
drive 1. 

Gi\es the new name 
BOOKFILE to DRAIT 
on drive 0. 



— RUN 



This command executes the BASIC program currently in 
memor\-. 



RUN 

RUN linenumber 



Executes the program currently in 

memory. 

Executes the program beginning at 

the hne number named. 
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RUN [!inenumber\ 

lineniLmber is the number of the line at which yoii want to 
hef^in execution ifyou don't want to start at the first line. 

Example: 

RUN 60 Executes the program from line 60, 

if^noring previous lines. 

SAVE 

SAVE stores a program on diskette. Ifyou include the m' sign 
when you SAVE a program whose name is the same as another 
program you already have saved on the same diskette, the pro- 
gram that is already saved is re[:)laced by the new program. Ifyou 
revise a program but want to keep both copies, save them under 
different names. 

SAVE -[\@\Ds:]filename",DevU 

Iff replaces an existing program that has the same file name. 
s is the drive number containing the disk on which ytm want to 
save the program. The default is 0. 

"filename" is the name of the program you want to save. 
Dev** is the de\'ice number of the disk dri\"e that contains the 
disk on which you want to store the program. The disk drive 
device number is 8 unless you change it. 

E.xamples: 

SAVE ■■1:MEYERFILE",8 Stores the program MEYERFILE on 

the disk in drive 1. 
SAVE ■•SCMFILE",8 Stores the program SCMFILE on 

the disk in drive 0. 
SAVE ■'@1:MEYERFILE ,8 Replaces the existing program 

MEYERFiLE in drive 1. 

SCRATCH 

Use this command to delete files from a diskette. When you 
issue this command, the compiiter displays the prompt ARE YOU 
SURE? belbre executing the SCFiATCH. You mus( respond with 
YES or Y to begin execution. 
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SCRATCH ■■{■ilename" [,Ds\ |ON Un] 

'Jilename" names the file yoii want to delete. 

s is the drive number ol' the file containing the file yon want to 

SCRATCH. The default is 0. 

n is the unit number of the drive. Use only if the number is not 

8. tlie default value. 

Examples: 

SCRATCH ■SCMFILE" Deletes the file SCMFILE 

ARE YOU SURE? YES from the disk in drive 0. 

SCRATCH ■THESIS',D1 L3eletes the file THESIS 

ARE YOU SURE? YES from the disk in drive 1. 

VERIFY 

Use this command to check a program on disk at^ainst the 
program currently in memory. VERII-'^' informs you if there are 
discrepancies. 

VERIFY- I Ds:)f//enQme",Dev# 

s is the drive number containing the stored program. 

The default is 0. 

"filename" is the name of (he file you want to verify. 

Dev** is the device number of the drive containing the stored 

]jrogram you're checking against the current program. 

The disk dri\'e de\'ice niunber is 8 unless you chajige it. 

Example: 

VERIFY -MEYERFILE'^S Checks the program MEYERFILE 

stored on drive against the pro- 
gram currently in memoiy. 

VERIFY "1 :MYFILE ,8 Checks the program MYFILE stored 

on drive 1 against the program 
currently in memoiy. 

BASIC STATEMENTS 

Statements are BASIC instructions that are issued in pro- 
grams. They are always preceded by a line number. Most of the 
statements described here can also be used as BASIC commands 
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in direct mode if you omit (he line number. Similarly, most BASIC 
commands can be used as BASIC statements in program mode if 
you prefix them with a line number. 



APPEND 

This statement opens a sequential file and positions the file 
pointers beyond the current end of file so that you can write addi- 
tional data to that file. APPEND is like the DOPEN statement, 
except that APPEND applies only to sequential files. 

[linenumber] APPENDUfn,- filename" [,Ds] [ON Un] 

/>! is the filenumber of the file you want to reopen and add to 

(this is called the logical file number). 

''filename" is the name of the file you want to APPEND. 

s is the number of the drive that contains the file (defaults to 0). 

n is the unit number of (he disk drive unit (defaults to 8). 

Example: 



10 APPEND#3;-MEYERFILE- Reopens MEYERFILE. logical file 

'3. on drive for appending. 



tfr 



BANK 

This statement sets the indirection bank number for use with 
some BASIC commands such as PEEK. POKE, BLOAD. and 
BSAVE that refer directly to memon,' bank locations. The BANK 
statement lets you pick the memoiybank into which information 
will be placed. There are 16 BANKs numbered through 15. 

[linenumber] BANK express/on 

evpression is any number, variable or numeric expression that 
equals any number between and 15, 

Examples: 
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10 BANK 3 

20 POKE 1024,20 

5 FOR A = 0TO5 



10 BANK A 



20 BLOAD' TEST" 



30 NEXT A 



Sets the bank number to 3. 

Stores 20 at location 1 024 in BANK 

3. 

Starts a loop that gives A a new 

value (0 through 5) each lime the 

loop executes. 

Sets the bank number to the value 

oi" A. which progresses from 

through 5. 

Loads the file TEST to the bank 

whose number is the value A. By 

the end of the loop. TEST is loaded 

in I3AXKS0 through 5. 



BLOAD 

This BASIC statement loads an executable machine language 
program into any memory location. 

\linenumber] BLOAD [fileoptions] [,ON Un] [,Bzl [,P/] 

I'ileopfions are the arguments that specify the file you want to 

load. They can include hie name, file number, drive number, 

drive unit number, etc. 

z is the nimiber of the memorv' BANK where you want to load 

Ihe machine language program. If you don't name a bank, 

BLOAD loads to the last bank named. If no bank has been 

named in Ihe program. BLOAD defaults to bank 15. 

/ is the location (low offset] in the bank where you want to start 

loading. 

Examples; 



_ IGBLOAD'RATES ■,Dl,ONU9,B3 



_ 20 BLOAD' TEST ,D1, 83, P1024 



Loads RATES from 
dri\e 1. drive unit 9. in- 
to BANK 3. 

Loads TEST into BANK 
3 from drive 1 starting 
at location 1024. 
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BSAVB 

This BASIC statement sa\'es a machine language program from 
any memon,- location you name. BSAVT-Z defaults to the last byte in 
the bank (SObFFFF. where b = bank through F). 

[linenumber] BSAVE ' filename '[.lileopts] [,ON Un] [,Qz] 
[,P/j[TOP/i] 

''filename" Is (he name of the file you want to sa\'e. 

fileopls niclude drive number, drive imit number, etc. 

y. is the number of the BANK where Ihc program is located. 

I is the location (low offset) in the bank where you want to start 

saving. 

h is the location (high olTset) in Ihebank where the information 

you're saving ends. 

Example: 

10 BSAVE TEST',D1 ,B3, Saves file TEST on drive 1, from 

P512 TO PI 024 BANK 3, memow location 512 to 

1024. 



CLOSE 

This statement closes a files that was opened previously with an 
OPEN statement. You must use the same file number in both the 
OPEN and the CLOSE statements. A CLOSE for a sequential out- 
put file writes the final buffer of output. 

[/inenumber] CLOSE fiienumber 

Example: 

100 CLOSE 3 Closes file number 3. 

CLR 

This command clears all BASIC variables currently in memon'. 
but leaves the program itself intact. The CLR command is auto- 
mat icallv executed when you give a RUN command. 
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[linenumber] CLR 
— . Example: 



10 


FORX 


= 


1 TO 4 


20 


A = 5 


B 


= X 


30 


C = A 


+ 


B: PRINT C,X 


40 


NEXT 






50 


CLR 






60 


PRINT C,X 




RUN 






6 




1 




7 




2 




8 




3 




9 




4 















Loop executes 4 limes. 
AsX is incremenled by 1. 
C and X are PRINTed on the 
same line until X = 4. 
CLeaRs all variables. 
PRINTS the CLeaRed variables. 

The values for C and X are 
PRINTed as the loop executes 
4 times. 

The zeroes PRINTed for C and X 
after the CLR statement show 
that the \'ariables are CLeaRed. 



-^ CMD 



This statement lets you redirect output. For e.\ample. output 
that would normally go to the screen can be redirected with CMD 
lo fin instead to a printer or a file. You must use CMD with an 
OPEN statement that uses the same file number. The device to 
which output will be redirected is named in the OPEN statement. 

[linenumber] CMD filenumber [,printlist\ 

Jilenumber is the number of the file whose output vou want to 
redirect. 

printlist is a list of character strings, numeric variables, or 
expressions wriKen to the device when the CMD statement is 
executed. 

Example: 

10 OPEN5,4 OPENS file number 5 and names 

the printer as the outpLit device (4). 
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20 CMD5, -PROGLIST' 
30 PRINT -TEXT" 



Directs PROGLIST to be written to 

the printer. 

PRINT statements following a CMD 

are directed to the device named in 

CMD. 



DATA 

The DATA statement holds numeric and string constants that 
are matched with variables in READ statements. The DATA con- 
stants are accessed consecuti\'e!y by READ variables. The variable 
type (numeric or string) in the READ statement must match the 
constant tv^pe in the corresponding DATA statement. Constants 
in DATA statements may be reread after you issue a RESTORE 
statement. 

The DATA statement does not have to precede the READ state- 
ment. When a READ statement has read all the constants in a 
DATA statement, it will look for another DATA statement, so the 
number of items in any DATA statement does not have to equal 
the number of items in a READ statement. However, the computer 
will display an OUT OF DATA error message if the total number of 
DATA constants accessible in a program is fewer than the total 
number of READ \'ariables. 

[linenumber] DATA constant\, constant, . . . , consfont] 

constant is any numeric (fLxed point, floating point, or integer) 
value or any string \'alue. Numeric expressions are not allowed. 
String constants do not need to be enclosed in quotation marks 
unless they contain commas, colons, or leading or trailing 
spaces. 



Examples: 




10 DATA 1,2,3,4,5 


Lists DATA constants. 


20 READA,B 


The first READ variable 


30 READ CD 


acquires the first DATA 


40 PRINT A;B;C;D 


constant, etc. 


RUN 




12 3 4 
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NEW 

^ 10 DATA 1 ,2,3,4,5 You can have more DATA 

— 20 READ A,B,C,D,E,F,G,H constants than READ variables 
_ RUN but not vice versa. 

— ?OUT OF DATA IN 20 



DCLOSE 

'' This command can CLOSE ail the files currently open on a disk, 
or only the logical file specified. If you don't specify a file number, 
all OPENed filed are CLOSEd. 

-, [(/nenumber] DCLOSE |#Ifl [ON Un] 

J/is the number of the logical file you want to CLOSE. 
— , n is the number of the drive unit. 

' ' Examples: 

10 DCLOSE Closes all files OPEN on default 

device (8). 
^ 10 DCL05Eft3 Closes the file with (he logical file 

number 3. 
" 1 DCLOSE ON U9 Closes all files OPEN on unit 9. 



DEF FN 

, — . This statement lets you define your own functions and use 

them in a program by using only the function name. This state- 
ment can save time and space when you want to use a comple-x 

— formula more than once in a program. You must define the func- 
tion with the DEF FN statement before you can call the function 
in a program, 

[linenumher] DEF FNna (argumenf) = formula 

— na is the name of the function. It must be a legal variable name, 
and you must precede the name with FN when you call the 
function. 

EXTENDED BABiCi.O- COMMANDS AND STATEMENTS 7\ 



argumenl can be any numeric variable: it must be enclosed in 
parentheses. 

formula is the expression that performs the function's opera- 
tions. Any variable name thai appears in this formula ser\'es 
only to define the fund ion: it does not affect program variables 
that have the same name. 

Example: 

10 DEFFNAB(X) = X/Y3 Defines the function FNAB. 

20 T = FNAB(i) Calls FNAB. 



DIM 

The DIMension statement aJlocates storage for an array and 
sets the maximum \'alues for the array variable subscripts. You 
MUST use the DIM statement to DIMension arravs containing 
more than 10 elements. To find the number of elements in an 
array, multiply the values of each subscript plus one. For e.xample. 
an array DlMensioned (3.2) has [3 + 1)*(2 + 1} elements. 

The DIM statement sets the value of all elements of the array to 
an initial value of zero. 

Matrices can have up to 255 dimensions, but the size of each 
must be less than 32767. 

[linenumber] DIM variable{subscript [, . . . ,subscript]), 
[variable {subscript [, . . . .subscript]) . . .] 

variable is the name of the array. 

subscript is the size of the dimension of the array. 

Subscripts must be enclosed in parentheses. 

Examples: 

10 DIM A(20) DIMcnsions a one-dimensional 

array with 21 elements. 

20 DIM AS(4,4,4) DIMcnsions a three-dimensional 

array with 1 25 elements (4 + 1 *4 + 
1*4 + 1 = 125). 
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DISPOSE 

Use this statement in error trapping procedures to eliminate 
^ unwanted FOR /NEXT loops or GOSUB /RETURN addresses with- 
out lca\'ing invalid information on (he slack. 

~ [linenumber] DISPOSE < FOR | GOSUB > 

You must choose either FOR or GOSUB as an argument for a 
~~' DISPOSE statemeiK. 

Example: 

^ 30 FOR J = 1 TO 10 Starts a FOR /NEXT loop. 

40 PRINT J 
" 50 IF J = 5 THEN DISPOSE Eliminates the loop when 
_ FOR:GOTO70 J = 5, and moves lo line 70. 

60 NEXT J 



DOPEN 

This statement declares a secjuential or random access file for 
read or write access. A sequential file is opened for read access 

unless you include the W argument in the statement. 

[linenumber] DOPEN Ult, ■■filename' \Xy] [.Ds] [ON Un] [, W] 

ifis the logical file number of the file you want to open. 

yUename" is the name of this file. 

y is the record length for a nonsequentiaJ file. You must include 

this argument when you create a relative file. 

s is the disk drive number. Default is 0. 

n is the disk drive unit number. Default is 8. 

W indicates write access to a sequential file. 

K.vamples: 

10 DOPENS5; TEST" Opens file 5 named TEST on drive 

0. 
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10 AS = 'RATES'' Opens file 6 named RATES. 

20 D0PEN#6,(AS) When you use a variable to stand 

for a file name, you must enclose it 

in parentheses. 
20 DOPEN#2;@FILEl,W",Dl Replaces file 1 with file 2 and opens 

file 2 on drive 1. 

END 

END terminates program execution and returns to direct mode. 

[iinenumber] END 

FOR/TO /STEP 

This compound statement starts a loop that performs a series of 
instructions a set number of times, and always executes at least 
once. This statement is always used with a next statement. 

FOR names a variable that serves as a counter to control the 
number of executions of the loop. TO sets the number of execu- 
tions, such as 1 TO 10. which means that the loop executes 10 
times. 

STEP is an optional part of the statement that you can use to 
change the amount the counter is incremented from the default of 
1. For example. 1 TO 10 STEP 2 makes the loop execute only 5 
times, since the counter is now incremented by 2 each time the 
loop executes. 

You can also count backwards in a FOR loop b\' reversing the 
order of the numbers in the TO arguments and by using a nega- 
tive \'alue as the STEP argument. 

You can also nest FOR /NEXT loops, that is. a FOR /NEXT loop 
can be placed inside another FOR /NEXT loop. Wlien you do this, 
the inside loop must end before the outside loop, and the loops 
must ha\'e a different variable as the counter. 

[Iinenumber] FOR variable = expression! TO expression2 
[STEP expressions] 

variable is the name of the loop counter. 
expressionl is the beginning value of the counter. 
expression2 is the ending value of the counter. 
expressions is the value of the increment of the counter. 
Defaults to 1. 
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Examples: 

10 FOR X = 1 TO 5 Sets X as the counter and limits 

to 5 (he number of executions of 
the \oup. 

20 A = A + X:PRINT A Each time the loop runs, this 

statement will execute again. 

30 NEXT Tells the computer to get the next 

value of X. 

10 FOR G = 1 TO 10 STEP 2 Starts a loop whose counter incre- 
20 PRINT G: NEXT G mentsby 2 each time the loop exe- 

cutes. 

10 FOR R = 25 TO 5 STEP -.5 Starts a loop whose counter decre- 
ments by -.5 each time the loop 
executes. 



GET 

This statement provides another way to assign data values to 
variables. GET scans the keyboard buffer and reads a single char- 
acter. If you don't type a character, a null character is automati- 
cally assigned. The GET statement is often placed in a loop that 
continues until you type a character that is assigned to the GET 
variable. 

The GET variable is usually a string variable, which can accept 
either string or numeric input. A numeric variable can only accept 
numeric input. 

[iinenumber] GET variable 

Example: 

10 GETAS: IF AS = "THEN 10 GET asks you to t_\-pe a single 

character that is assigned to 
AS. The IF tells thecompulcr to 
keep checking until you enter a 
character, 
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GET* 

GET*' reads a single character from a file. You musl have 
already OPENcd the file with the same lofiical file number before 
you can use GET". 

[Unenumber] GET# filenumber, variable 

filciMunber is ihe logical file number of the OPENed file from 

which your GET" is reading a eharacler. 

variable is the variable to whieii (he character read by GET" is 

assigned. 

Example: 

10 DOPENttS, -TEST" Opens logical file 5, 

30 GETftS, FS Reads a single character IVom file 5 

and assigns it to FS. 



GOSUB 

The GOSUB statement lets you branch to a subroutine. The 
subroutine must be terminated by a RETURN statement that 
sends control back to the body of Ihe program. You can nest 
GOSUB /RETURN statements up to 23 deep. 

[Unenumber] GOSUB tinenumber2 

linenumber2 is the line where the subroutine starts. 

Examples: 

75 GOSUB 10 Sends control toasubroutinestart- 

ing at line 10. 
95 GOSUB 125 Sends control to a subroutine at 

line 125. 

GOTO 

GOTO unconditionally branches the program to a specified line. 
GOTO does not reciuirc any sort of return statement. If you want 
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to stop a loop begun by a GOTO statement, you must break into 
execuiion with a STOP or include another statement that ends 
the loop. 

[linenumber] GOTO Iinenuniber2 



Examples; 

10 INPUT AS: PRINT AS 
20 GOTO 10 

10 INPUT A; PRINT A*l. 06 
20 IF A<100 GOTOIO 
30 IF A= > 100 THEN END 



IF/THEN /ELSE 
IF/GOTO 



The GOTO in line 20 causes 
line 10 to execute repeatedly. 

The IF statements provide a 
way lo end the GOTO loop in 
line 20. which stops executing 
when line 20 is false. 



The IF statement is another way to control program execution. 
This statement tells the computer lo check IF a condition is true, 
and IF it is, follow the instructions following THEN. IF that condi- 
tion is false, the program skips to the next line to continue. You 
can use an IF statement to start a loop or to decide whether cer- 
tain parts of a program will execute. IF statements may be nested. 

[linenumber] IF expression THEN fc/ouse [:ELSE ectause] 

expression sets the condition to be verified. The THEN clause 
instructions are executed only if the expression is true. 
tclause is the set of instructions to be performed when the 
expression is true. 

eclause is another set of instructions to be performed when the 
expression is false. 

Elxpressions in IF statements usually include one of the follow 
ing relational operators; 



SYMBOL MEANING 
> greater than 
< less than 

= ec[ual to 



SYMBOL MEANING 
< > not equal to 
>= equal to or greater than 
<= equal to or less than 
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Examples: 

10 IF A> BTHEN PRINT A,B 

10 IF A>100 GOT0125 

10 IF A< = 99THEN A = 
A'l.SiELSE A- 2 



A and B are printed only if A is 
greater than B. 

If A is greater than 100, execution 
goes to line 125. 

If A is less than or equals 99. in- 
structions after THEN arc executed 
and the ELSE clause is not. If A is 
greater than 99. THEN's aigumenl 
isn't executed, and ELSE's is. 



INPUT 

This statement lets you injjut values from the keyboard during 
execution. Wlien you execute the program, you are automatically 
prompted by a question mark for INPUT. You can also write a 
prompt message. Program execution does not contintie until you 
respond to an INPUT prompt. 

The number of data items you supply in response to an INPUT 
prompt must equal the number of variables in the INPUT state- 
ment. INPUT variables may be either string or numeric. INPUT 
assumes that commas and colons signal the end of a data item. 

[tinenumber] INPUT {" promptstring' ;] variable list 

"promptstring" is optional text you can add to precede the ques- 
tion mark prompt. 

variable list is one or more variables whose \'alues you are 
INPUTting. 

Example: 

10 INPUT AS: PRINT -CONTINUE 'As long as you dont enter 
20 IF AS <> STOP" GOTO 10 STOP when you are prompted 
RUN for INPUT, execution 

? COMMODORE continues and you 

CONTINUE are prompted again. 

? B SERIES 
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CONTINUE 

?STOP 

READY 

INPUT* 

INPUT** is similar lo the INPUT statement, except it reads data 
from an OPENed disk file. Leading spaces are ignored. 
INPUT" assumes thai commas, colons, and carriage returns 
signal (he end of a data item. 

[tinenumber] INPUTtt filenumber, variable list 

/ifenumJber indicates the file from which INPUT** is reading data. 
variable list is one or more variables whose values \'ou are 
INPUTting. 

Example: 

10 INPUTff3,AS,A Reads values for AS and A from 

file 3 



« LET 



LKT assigns a \'alue to a \'ariablc. The word LET. however, is 
always optional. In other words. LET A = 3 is the same as A = 3. 
The presence of the equal sign is sufficient when you are assign- 
ing an expression to a variable. 

[Hnenumber]\lEl\ variable = expression 

Examples 

10 LET AS = ■STRING" 

20 A = 32-28 

30 BS = 'STRING' 

NEXT 

NEXT is the statement that does the following: 

EXTENDED BASIC JO- COMMANDS AND STATEMENTS 79 



• iiitiifales where a FOK/NEXT loop eiids 

• increments the value of the FOK value by the amount declared 

hi Ihe STEP argument (default - 11 when the loop is not 
finished 

• sends execution otil of the FOR loop when (he looj: is finished. 

NEXT only appears as the complement of a FOR loop, and every 
FOF-i loop must ha\'e a NEXT slatemcnl. These loops may tac 
nested. 



[linenumber] NEXT [variable, . . . ,variable\ 

variable is optional: when loops are nested (he first NEXT is 
assumed to go with Ihe last FOR statement. Wlien Ihe NEXT 
variable is included, it must malch the p-QK variable. 

Example: 

10 FOR A = 1 TO 2: PRINT A U)op A executes twice. 
20 FOR F = 99 TO 97 

STEP-1:PRINT F Loop F. executes 3 times. 

30 NEXT F,A Loop F, the last named, is 

RUN (he firs! finished. 

1 Loop A runs once. 

99 Loop F runs all three times 

98 because it finishes before A 

97 can execute a second lime. 

2 Ixiop A runs another time. 

99 IvOop F runs ihree times af^ain 

98 because it is inside A. 
97 



ON/GOSUB 

This compound statement branches the prof^ram to one of sev- 
eraJ subroutines specified by the line numbers listed as GOSUB 
arguments. The deslinalion depends on ihe value redirned when 
(he ON ex|:ression is evaluated. If the vakie is 1. control branches 
lo [he first subroutine: if iCs 2. control goes to the second. e[c. If 
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the vakie of (he expression is negative, you receive an error mes- 
sage. If the expression is zero or greater than the number of items 
in the list, control [>asses to the line following the ON /GOSUB 
statement. 

\linenumber\ ON expression GOSUB list of /inen umbers 

expression determines which subroutine receives conirol when 
the e.KiDression is c\'alualed. 

list ojlinenninbers corresponds to the subroutine to which the 
program might branch. 



E.\amplc: 

10 FOR A = 1 T0 3 The fir-st time the FOR loop 

20 ON A GOSUB 75,95,1 1 5 executes, control passes to 
30 NEXT the I'irst subroutine (at line 75) 

because A = 1. etc. 



ON /GOTO 

ON /GOTO resembles ON /GOSUB, except that ON /GOTO sends 
eonlrol to one of several specified line numbers rather than to 

— subroutines. All other conditions are the same. 

"^ [Itnenumber] ON expression GOTO list of linenumbers 

cx/jrcssitm determines which lines receives control when tlie 
expression is evaluated. 

— list of Utiennmbers corresponds to the line numbers to which 
the program niighl branch. 

ExamjDle: 



50ONX-1 GOTO 125,150,200 WhenX-1 = 1, control goes to line 

125; when X- 1 =2. control goes 
to 150, etc. 
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OPEN 

This statement establishes an hiput /Output (I/O) channel to 
the screen or to an external device such as a disk drive, a printer, 
or the IEEE bus. 

[linenumber] OPEN filenumber [.devicenumber [, secondary 
address ( ,' filename"]]] 

filenumber of the logical number o{ the file you want to OPEN. 

This number must be between and 255. 

devicenumber designates the external device to which you 

want to OPEN a channel. The device numbers for external 

devices are: disk = 8 through 15 (default 8): printer = 4: 

screen = 3. 

secondanj address (0 through 15) is required in some cases. 

The addresses are: through 1 = commands other than 

OPEN: 2 through 14 = data files; 15 = command channel. 

''filename" is the name of the file referred to in the secondary 

address. 



Examples: 

10 OPEN 1 ,3 OPENS the screen as a device. 

20 OPEN 2,4 OPENS a channel to the printer. 

30 OPEN 4,8,1 5 OPENS a command channel on 

the disk. 

PEEK 

PEEK* lets you read the information at a specific memory loca- 
tion. PEEK returns the value (0 - 255) of a single byte. 

[linenumber] PEEK (memoryfocofion) 

memory location gives the memory address of the byte whose 
value you want to read. 



PEEK cind POKE default lo the BASIC lexl bonk. H you wani to 
access onolKer bank, you must issue the BANK coriinioiid hrst. 
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Example: 

10 A = PEEK(59468): PRINT A PRINTs the value of the byte 

located in memory^ at 59468. 



~ POKE 

"" POKE* lets you write a byte into a specific memory location. 
„ POKE is complemented by the function PEEK. Use PEEK and 

POKE for efficient and specific data storage, and for assembly 
~ language subroutine operations such as loading and passing 

arguments. 
You can only POKE to RAM (Random Access Memory), though 

— no error is llagged if you POKE to ROM (Read Only Memory). 

[linenumber] POKE location, value 

_ locaiion is the place in memorj' where you want to place a 

\'alue. 
"^ value is what yon want to place in a specific memory' location. 

Example; 

~ 10 POKE 59468,14 Sets the character set to 

■ — ' tipper /lower case mode. 

_ 20 A = PEEK(59468):PRINT A PRINTs 14 as the value for A 

since you previously POKEd 

— 14 into location 59468. 

_ PRINT 

„ PRINT displays on the screen any information you specify. The 
punctuation you use in the PRINT statement determines the 
"" position of PRINTed items. BASIC divides' each line into print 
_ zones of ten spaces each. When you separate PRINT items with a 
comma, each item is PRINTed in a new print zone. A semicolon 
" PRINTS items right next to each other (however. PRINTed num- 
bers are always followed by a space). 
If you end a PRINT statement with either a comma or a 
~ semicolon, the next PRINT statement begins on (he same line. If 
_ there is no punctuation at the end of the statement, a carriage 

• PEEK and POKE detoult lo ihe BASIC tex^ bank. If you want lo 
access anolher bonk, you must issue the BANK command first. 
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return is assumed, and the next PRINT statement begins on tin- 
next line. 

[linenumber] PRINT \printtist] 

priiUlist can include any nfthe following: 

1. Text, which must always be enclosed in quotation marks. 

2. Variable names: if enclosed in quotation marks, the value of 
the variable PRINTS: if not enclosed, the variable name 
PRINTS. 

3. Functions. 

4. Punctuation marks (used for formatting output. 

Examples: 

Stotement Prinfs 

10 A = 3'4: PRINT "A = '-,A A = 12 

20 PRINT ■■REPORT TITLE" REPORT TITLE 

30 A = 3;PRINT"A = ■■;A;'B = '■;A*2 A = 3 B = 6 

40 PRINT 1,2,3 1 2 3 

50 PRINT 1;2;3 1 2 3 



PRINT* 

PRINT* resembles PRINT, but PRINT" writes the values listed to 
the file a.ssoclated with the file number in the PRINT'* statement. 
Recall that (he file must have been previously OPENed with the 
same file number. 



\f)lenumber] PRINT# filenumber, printlist 

filenumber identifies the loglca] file into which you want to write 

data. 

printlist contains the data you want to write to the file. 

Example: 
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10PRINT«3; TEST DATA:' 



Writer this information to file 
number 3. 



PREVT USING 
PRINT* USING 

These statements let you define the format of the string and 
numeric output you want to print. 

\linenumber] PRINT \t^filenumber,] USING "formatliit"; printlisf 



filenumber names the file into which you wish to write format- 
ted data. The file must have been previously OPENcd. 
"/ormafhsr" defines the format of your output. 
prinilist is the data you want to PRINT in the defined format. 
The format symbols are: 



CHARACTER 



NUMERIC STRING 



Pound Sign (ff) 
P[us(+) 
Minus (-) 
Decimal Point (.) 
Comma (,) 
Dollar Sign (S) 
Four Carets( Itll) 
Equal Sign ( = ) 
Greater Than Sign ( >) 



X 
X 
X 
X 
X 
X 
X 



X 
X 



The pound sign (*) reserves room for a single char- 
acter in the output field. If the data item contains more 
characters than you have * In your Jormat field, the 
following occurs: 



• For a numeric item, the entire field 
asterisks (*), No numbers are printed. 
For example: 



is filled with 
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• 



10 PRINT USING ■■««««■■ ,X 

For these \'alues for x, this format displays: 

A = 12.34 12 

A = 567.89 568 

A = 123456 **** 

For a siring item, the string data is truncated at the bounds of 
the field. Only as many characters are printed as there are 
pound signs (*) in the format item. Truncation occurs on the 
right. 

For e.xample, ifyou want a field to contain a maximum of .seven 
characters, you can use (his PRINT USING statement to print a 
string variable: 

PRINT USING ■#######■' ; NAME,S 

If the string NAMES contained more than seven characters, the 
characters after the seventh character will be truncated when the 
string is printed. For example, if NAMES = "SHABINGER". this 
format will print SHABING. 

The plus ( + ) and minus (-] signs can be used in either the first 
or last position of a formal /ie/d but not both. The plus sign is 
printed if the number is positive. The minus sign is printed if the 
number is negative. 

If vou use a minus sign and the number is positive, a blank is 
printed in the character position indicated by the minus sign. 

Ifyou don't usecither a plusor minus sign in youvlbrn~ial field 
for a numeric data item, a minus sign is printed before the first 
digit or dollar symbol if the ntimber is negative and no sign is 
printed if the number is positive. This means that you can print 
one character more if the nimiber is positive. If there are too many 
digits to fit into the field specified by the " and + /- signs, then an 
overflow occurs and the I'ield is filled with asterisks (*}. 

A decimal point I.) symbol designates the position of the 
decimal point in the number. You can only have one decimal 
point in any Jbrma(/ie/d. Ifyou don't specify a decimal point in 
your/ormaf /['e/d the value is rounded to the nearest integer and 
printed without any decimal places, 

86 EXTENDED BASIC 1 0* COMMANDS AND STATEMENTS 



When you specify a decimal point, the number of digits preced- 
ing the decimal point (including the minus sign, if the value is 
negative) must not exceed the number of* before the decimal 
point. If there are too many digi(.s, an overflow occurs and the field 
is filled with asterisks (*), 

A comma (.) lets you place commas in numeric fields. The posi- 
tion of the comma in the format list indicates where the comma 
appears in a printed number. Only commas within a number are 
printed. Unused commas to the left of the first digit appear as the 
filler character. At least one " must precede the first comma in a 
field. 

If you specify commas in a field and the number is negative, 
then a minus sign will be printed as the first character even if the 
character position is specified as a comma. 

A dollar sign (S) symbol shows that a dollar sign will be printed 
in the number. You must specify at least one # before the dollar 
sign or else the dollar sign will not /loaf. If you specify a dollar sign 
without a leading *. the dollar sign is printed in the position 
shown in the/ormaf/ie/d. If you specify at least one *' before the 
dollar sign, the dollar sign floats to be placed Just before the 
number. 

If you specify commas and /or a plus or minus sign in ajormat 
field with a dollar sign, your program will print a comma or sign 
before the dollar sign. 

The /oiircarefs ( tilt ) symbol is used tospecify that the number 
is to be printed in E-i-format. You must use * in addition to the 
tttt tospecify the field width. The ftfT can appear either before or 
after the * in the/ormaf /it'/d. 

You must specify /our carets ( till ) when you want to print a 
number in E-format (scientific notation). Ifyou specify more than 
one but fewer than four carets, you will get a svntax error. If \'ou 
specify more than four carrets. only the first four are used. The 
fifth caret is interpreted as a no text symbol. 

An equal sign (=) is used to center a string in the field. You 
specify the field width by the number of characters (* and =) in 
{he format field. If the string contains fewer characters than the 
field width, the string is centered in the field. If the string contains 
more characters than can be fit into the field, the rightmost char- 
acters are truncated and the string fills the entire field. 

A greater than sign (>) is used to right Justify a string in a field. 
You specify the field width by the number of characters l" and =) 
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in ihc fonuat field. W ihe strin,t* contains Icwer characters than 
the field width, thestrini^ is right justified in the field. If the string 
contains more characters than can be fit Inio the field, the right- 
most chararlers are trimcaled and the string fills Ihe entire field. 

Examples: 



Field Expression Result Comment 



+nu 



#.fl#+ 


-.01 


0.01- 


-.## 


-.1 


-.10 


ttff.ft- 


1 


1.0 


+un+ 


1 


ERROR 


+un.u- 


1 


ERROR 


nunn 


-100.5 


-101 


uuuu 


-1000 


* * • ■ 


n.ttn 


-4E-03 


-.00 


nun. 


10 


10. 


n.n. 


1 


ERROR 


nn.nn 


100 


1,00 


nn,nn 


10.4 


10 



n.nnn.nn 1000.009 1,000.01 
nuM -1 -1 

nn,nn -10 -10 



»«=>.> 
+>==,# 



1000 



+>=#,# 1 
ff$»# 1 



+ 1 Fill character between sign and 

number. 

Leading zero added. 
Leading zero suppressed by 
minus sign. 
Trailing zero added. 
Two plus symbols. 
Plus and minus symbols. 
Rounded to no decimal places. 
Overflow because four digits 
and minus sign cannol fit in 
field. 

Rounded to -0 
Decimal point added. 
Two decimal points. 

Comma suppressed and value 

rounded. 

Rounded. 

Comma suppressed. 

Minus overrules comma. No 

leading digit before the comma. 
1000.0 > ond = treated os ft since in 

numeric field. 
+ >= = ,1 At least one # must precede the 

comma. >, =, and comma ore 

treated as symbols to print, not 

as format field items. 
+ 1 > and = treated as # since in 

numeric field. 
$1 Leading S sign. 
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Fi&ld Expression Result Comment 



«B«S 


-1 


-SI 


ttffSfttt 


-1 


-$1 


«ffffS- 


-1 


SI 


+snnu 


-1 


+$-1 


+nsun 


-1 


-$1 


+ ».wnn 


1 


+ 1.0E+00 


uu.uuu]i 


-1 00000 


l.OOE+05 


##,n 


1 


ERROR 


uttwui 


34 


34E+00I 


ttff.ffftiin 


cbm 


cbm 


ffHft>ft 


cbm 


cbm 


=»««# 


cbm 


cbm 


ff,Sff= + 


cbm 


cbm 



Sign precedes S. 

Sign precedes $. 

Sign in lasf position. 

At least one U must precede S, + 

and $ treated as symbols to 

print, not as format field items. 

E format output 

Only three carets. 
Fifth caret seen as text char- 
acter and is always printed. 
String data item, printed left 
justified in nine character 
field. 

Printed right justified in five 
character field. 

Centered in eight character 
field. 

Only + affects centering in six 
character field. Other symbols 
are translated to ft. 



— PUDEF 



PUDEF lets you use cliaracters in a PRINT USING statement 
thai are not permitted in the PRINT USING Ibrniat list. PUDEFlct 
you redeOne up to 4 symbols in the PRINT USING .statement. You 
can change blanks, commas, decimals points, and dollar sif^ns 
into some other character i^y placinj^ the new characler in the 
correct position in the PUDEF control string. 

[/inenumber) PUDEF confro/string" 

conirolslring is a list ol'new characters you want to place in your 
F'RINT USING format. The control string can contain up to four 
new characters: 

• (Character position 1 is the Oiler character. The default is a 
blank. Place a new cliaracter here when you want another 
character to appear in place of blanks. 
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• Character position 2 is (lie comma character. Default is a 

comma. 

• Character position 3 is the decimal point. 

• Character position 4 is the dollar sign. 

E.xamples; 

10 PUDEF'-" PRINTS * in the place of blanks. 

20 PUDEF- @- pr-lINTs # in place of commas, 

30 PUDEF ■ „■■ PRINTS decimal points in place of 

commas, and commas in place of 

decimal points. 

READ 

This statement assigns values from DATA statements to varia- 
bles listed as READ arguments. The data types must be the same 
In both statements. A single READ statement may read data from 
several DATA statements, and several READ statements may read 
from one DATA statement. DATA lists must contain enough 
\'alues to assign one value to each READ \'ariable. but any e.xtra 
DATA values are ignored. 

You can reREAD data by using the RESTORE statement. 

[/j'nenumberj READ variable list 

variable list is the list of variables whose values are assigned 
from DATA statement constants. 

Examples: 

1 DATA 1 ,2,3 Assigns 1 to A. 2 to B, 

20 READ A,B,C and 3 to C. 

10 DATA 1,2,3,4 

20 READ A,B:PRINT A;B Assigns 1 to A: 2 to B. 

30 RESTORE Moves pointer reading data 

40 READ C,D:PRINT C;D back to beginning, so 1 is 

RUN assigned to C: 2 to D. 

1 2 

1 2 
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RECORD 

RECORD adjusts a relative file painter to seleO any byte (char- 
acter) of any record in (he relative file. The file must have been 
l)revinusly OPENed. 

[linenumber] RECORDtt lilenumber,recordnumber[,bytenumber] 

fUenumbcr is the logical number of the relative file. 
recordniimber is the number of the relative file record in which 
the byte you want to select is located (must be between and 
65535). and 1 both inde.\ the first relative file record. 
byteniimber indicates at which b\te ( 1 through 254) you want 
to select. 

Examples: 



10 DOPEN|i2; RELFILE 150 OPENs a relative file with a record 



20RECORDff2,)0,50 
25 PRINTff2,CHRS(255} 
30 DCLOSEff2 

)0 FOR J = ) TO 10 
20 RECORD»2,(J)J 
30PRINT«2, RECORD ;J 
40 NEXT 



length of 50. 
Allocates space for 10 
records and moves the 
pointer to the end. 

Writes ten records to 
position 1 in each record. 



REM 

The REMark statement lets you insert explanatory remarks in 
your programs. These remarks are not executable and do not 
affect the program. 




[Imenumber] REM [text] 

text can be any commentary that clarifies vour program. 
REMarks do not need to be enclosed in parentheses. 
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Examples: 

10 PRINT X: REM X IS TAXABLE TOTAL All text following REM 
20 REM REMARKS MAKE PROGRAMS does not execute. 
EASY TO READ 



RESTORE 

RESTore le(syou reREAD the values in a DATA statement from 
the beginning. 

[imenumber] RESTORE \linenumber2] 

Hnenumbcr2 is the line luimbcr where the pointer is mo\'ed 
back for DATA to be rcREAD. 

Examples: 

10 DATA 1,2 

15 DATA 8,9,10 

20 READ A, B, CD: PRINT A;B;C;D Asigns first 4 DATA values. 

30 RESTORE 15 Moves pointer to start of 15. 

40 READ E,F,G: PRINT E;F;G Assigns data from start of 15. 

50 RESTORE Moves pointer to start of first 

DATA statement. 
60 READ A,B,C:PRINT A;B;C Assigns first 3 DATA values. 

RUN 

12 8 9 

8 9 10 

1 2 8 



RESUME 

This statement lets you continue with program execution after 
an error has been trapped and processed b3' your error handling 
routine. Ifyou do not name a specific line at which execution is to 
RESUME, the program will attempt to re-execute the statement in 
error. Ifyou select the NEXT argument, execution resumes at the 
line following the error. Ifyou select some other line number, exe- 
cution continues there. 
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ll;nenumber) RESUME [NEXT | Iinenumber2] 
lineniimber2 is any line you selecl for execution to resume. 
Example: 

70 TRAP 100: REM IF AN ERROR Sends program to line 100 
OCCURS GOTO LINE 100 if there is anv error in 

75 PRINT VAL(L): REM THIS IS the prof^ram." 
AN ERROR BECAUSE L = 

120 RESUME NEXT Restarts program at line 

after error. 

RBTUIIN 

RETURN ends a subroutine and branches the program back to 
the statement following the GOSUB statement that started the 
subroutine. 

\tinenumber] RETURN 

Example: 



50 

60 

65 

70 

80 

90 

100 

RUN 
SUBROUTINE STARTS 
MORE SUBROUTINE 
ENDING SUBROUTINE 
• SUBROUTINE OVER- 



GOSUB 70 

PRINT •■ SUBROUTINE OVER " 

END 

PRINT -SUBROUTINE STARTS' 

PRINT MORE SUBROUTINE' 

PRINT ENDING SUBROUTINE' 

RETURN 



Passes control (o subroutine 
at line 70. 

Subroutine begins. 



Ends subroutine and passes 
control back to the line 
following GOSUB. line 60. 
which executes only after 
the subroutine is over. 




STOP 

This statement terminates program execution and returns con- 
trol to command level, aJso called direct mode. You can resume 
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execiilion with the CONT siatemcnt if you follow Ihc restrictions 
detailed in the description of CONT. 

[/menumberj STOP 



SYS 

Use this statement to call a machine language subroutine. This 
subroutine is located at the jumpaddrcss named as the SYS 
argument. This address is decimal, not hc.xidecimtil. 

SYS jumps to the last bank named in the program. If no bank 
has been named. SYS jumps to bank 15. If SYS jumps to any bank 
other than 15. RAM-loaded transfer of execution routines must be 
present in the bank. 

NOTE: All machine language programs must end with an RTS 
(ReTurn from Subroutine) statement, which returns to the BASIC 
program. 

[iinenumber] SYS jumpaddress 

Jumpaddress is the decimal address of the machine language 
subroutine being called by the program. 

Example: 

40 SYS 51 2 Calls the machine language sub- 

routine at decimal address 512. 



TRAP 

This statement prevents BASIC'S normal error handling func- 
tions from taking control. When an error occurs. TRAP lets your 
program perform its own error handling routines that you've writ- 
ten into the program. Three error-handling functions, EL, ER, and 
ERRS, are explained in Appendix A. 

[Iinenumber] TRAP [Ilnenumber2] 

lineniimber2 Is the line where your error handling procedures 
begin. 
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Example: 

360 INPUT B 

370 IF B = THEN TRAP 550 [f B = 0, an error occurs because 
380 X = A/B: PRINT X BASIC won't divide by 0. TRAP 

passes to line 550 where this error 
is fixed without the program being 
stopped because of the error. 

WAIT 

WAIT suspends program execution while monitoring the status 
of data input from the specified location. The values of selected 
bits at the specified location determine whether the WAIT state- 
ment is re-executed, or control passes to the next executable 
statement. 

When you use the WAIT statement, the program is on hold, 
waiting until a machine address you name develops a specific bit 
pattern. The data read at the addre.ss is exclusive Ored with 
mask2, whose default is 0. Then the data is ANDed with maskl. If 
the result is zero, BASIC loops back to reread the data, making 
execution WAIT. If the result of the OR and AND operations is not 
zero, execution continues with the next executable statement. 

NOTE: If you enter an indefinite loop with a WAIT statement, 
you must manually reset the machine. 

[linenumber] WAIT location, maskl [,mask2] 

maskl is the value with which the specified data is ANDed. 
mask2 is the value with which the specified data is exclusi\e 
ORed. 

Example: 

55 PRINT -PROGRAM WAITS TIL ANY 

KEY IS PRESSED" 
60 POKE 209,0 Puts in memory location 

209. 
70 WAIT 209,1 Makes program wait until 

anv kev is pressed before 
80 PRINT -SOME KEY WAS PRESSED' resumiiig. 
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BASIC 4.0 
FUNCTIONS 



L^ 






ABS ^ 

ABS (expression) ^ — '' 

Returns !hc absolute value of" (expression), '' — ' 

Example. 

PRINT ABS(7*(-5)) 

35 ^' 

ASC w 

ASC (expression) ^ — 

Returns the numeric value that represents Ihe ASCII codeof the — 
first character of (expression), which is a slrini^ value. The CHRS 
function performs ASC IMo siring conversion. 

Example. 

10 XS = TEST" -^ 

20 PRINT ASC (XS) 

RUN 

84 T is ASCII code 84. L-, 

ATN "" 

ATN (expression) 

RctLirns the ajxtan,[fenl of (he (expression) in radians. The 

result is in (he range -pi /2 to pi /2. The expression can be any ■ 
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numeric type, taul the evaluation ol' ATN is always performed In 
floating point binar\'. 

Example. 

10 INPUT X 
20 PRINT ATN (X) 
RUN 
? 3 
1 .24904577 



CHR$ 

CHRS (expression) 

Returns a string containing a single character whose value is 
the character with the ASCII code represented by (exprc.ssionl. 
These codes are listed in Appendix D. The expression can be any 
integer between and 255. 

CiiRS is ol'len used to send a special cliaracter to the lerininal. 
P'or example. C11RS(14) switches the screen to upper /lower case 
(normal) mode. 

The ASC (unction performs ASCII-to-numeric conversion. 

Examples: 

10 ES T CHRS (147) + ERROR MESSAGE' 

20 PRINT ES: REM CLEARS SCREEN AND PRINTS MESSAGE 

10 NS = CHRS(83) + CHRS(77) 

20 PRINT NS 

RUN 

SM 



COS 

COS (expression) 

Returns the cosine of (expression) in radiajis. Expression is any 
valid numeric expression. The evaluation of COS is always per- 
formed in floatingpoint binary. 
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Example; 

PRINT COS(5-l) 
-.65364362 

10 X = 2-COS(.4) 
20 PRINT X 
RUN 
1.84212199 

ERR$ 

ERRS {expression) 

Relurns a character string which contains the text of the error 
message represented by [expression]. The value of expression 
must be between and 127. 

When used with the TRAP statement. ERR$ helps you process 
error messages within your program. 

Exam]Dle: 

35 REM IF USED WITH TRAP EL HOLDS THE ERROR LINE 

WHILE ER HOLDS THE ERROR U 
50 PRINT ERRS(1 ):REM THIS WILL PRINT AN ERROR 

MESSAGE 
70 TRAP 1 10:REM GO TO LINE 1 10 IF AN ERROR OCCURS 
80 PRINT VAL(K):REM THIS IS AN ERROR 
90 PRINT "WE HAVE RETURNED FROM OUR TRAP 

ROUTINE" 
100 END 
110 PRINT ERROR IN LINE'EL: REM PRINT THE LINE WITH 

THE ERROR 
120 PRINT 'THE ERROR IS ERRSlER) : REM DISPLAY THE 

ERROR 
130 RESUME NEXT:REM RESUME EXECUTION AFTER LINE 

WITH ERROR IN IT 

EXP 

EXP (expression) 
Returns the value of e (approx. 2.71828183) raised to the power 
represented by [expression]. Expression must be less than or 
equal to 88.02969191. 
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Examples: 

?EXP(1) 
2.71828183 

_ ?EXP(3.5)/2 

16.557726 

-^ ?EXP(89) 

'^ ?OVERFLOW 

~^ FRE 

PRE (expression) 

Returns Ihe luimbtToCrree bvlcs in a meinorv sct^menl or bank 

— indicait'cl by {exijressioii]. IT you liave a 128K machine, banks 1 
and 2 contain 64K each, and (he other banks are empty. If vou 
have a 256K machine, banks 1. 2. 3. and 4 contain 64K each, and 

— V ihc odier banks are em]3(v. 

E.\aiii[jk": 

'^ ?FRE(1) 

— 63908 

" ?FRE(1) + FRE(2) 

— 128095 

— INSTR 

'"* INSTR {expression! ,e>ipresslon2[ .expressions]) 

■"" The INSTR function performs a subslring search. The te.xt of 

strin.t^ (t^v/jre-s-sion /) is searched, beginning at chtiracter position 

(c.v/jrc.s.sionS). for I lie occurrence ol' si ring [expression'J], Numeric 
■ ■ expressions must be a vakie between 1 and 255. The del'aull for 
__^ expression 3 is 1. 

■ INSTR returns these values: 

• If expression 2 is NOT found in expression 1, INSTR rcttu-ns 

— zero (01. 
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• If e.\pression2 is foLind. INSTK rt'iurns the posilion in siriiit^ 
expression 1 ihai contains the first character of expression2. 

Example: 

10 AS = -TEST TEXT' 

20 BS = TEXT 

30 PRINT BS;'TEXT STARTS AT CHAR ;INSTR(AS,BS) 

RUN 

TEXT STARTS AT CHAR 6 

INT 

INT (expression) 

RetLinis the lar£j;esi integer wliich is less than or et|t!al to Ihe 
value of [expression]. 

Example: 

PRINT INT (99.89) 

99 
PRINT INT( -28.8) 

-29 

LEFT$ 

LEFTS [exptessionl , expression2) 

Returns a siring thai ronsisis of a number {cxpression2] of 
eharaeiers from astrin.t; {expression I) starlint^ from the leflntosi 
character in [expreasion I]. Ex[]ression2 nirist be an integer be 
tween 1 and 255. 

If expression2 is greater than (he length of expression 1. then 
the LEF-T8 function returns the entire string. Use the LEN fuiic- 
tifjn to find Ihe length of expression 1. 
Example: 

10 AS = COMMODORE COMPUTERS 

20 BS = LEFTS(AS,9) 

30 PRINT BS 

RUN 

COMMODORE 
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LEN 



expression] 



r^eturns the number of characters in {expression]. Non-printing 
characters and blanks are counted. 

Example: 

10 XS = "COMMODORE COMPUTERS" 
20 PRINT LEN(XS) 
RUN 
18 



LOG 

LOG (expression) 

Returns the natural logarithm of {expression). Expression must 
be greater than zero. 

Example: 

PRINT LOG (45/7) 
1 .86075234 



MID$ 

MIDS {expressionl , expression? [,expression3]) 

i^ciurns a string that contaiii.s a number {e.vpressio!\3] of'char- 
aciers IVorii string {expression 1]. starting at the character posi- 
lion. named in {expression?]. Expre.ssion2 and expres.sionS must 
be between 1 and 255. 

IJ'yoLi do not supply a value for expressions or il' (here are fewer 
than expressions characters in the string expression 1. (hen the 
Mins function returns all of the rightmost characters of expres- 
sionl. beginning with the expression2 character. 

If you spccily a value for expression2 (hat is greaier Ihan (he 
length of (he stritig expressionl. then the MIDS function returns 
a null string. 
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Example: 

10 AS = 'GOOD" 

20 B$ = MORNING EVENING, FRIENDS" 

30 PRINT AS;MIDS(BS,9) 

40 PRINT AS;MID${B$,9,7) 

RUN 

GOOD EVENING, FRIENDS 

GOOD EVENING 

PE£K 

PEEK (expression) 

RetLirns the byle read from memory location [expression] in (he 
bank selected by a previously executed BANK instruction. Expres- 
sion must be between and 65535. 

PEEK is the com]3lementan' function to the POKE statement. 
See the POKE statement for more information. 

Example: 

20 PRINT PEEK (36879) 
RUN 
46 

POS 

POS (expression) 

Returns the column number of the current cursor position. The 
leftmost position is 0: the ri,t;ht most position is 80, Expression is 
a diiinmy arifmnenl. which means that you can ^ive it any \'aliie 
because it doesn't alTcct the lu net ion cvakialion. 

Example: 

50 IF POS(X) :■ 60 THEN PRINT CHRS(13) 
60 REM CHRS(13) IS THE RETURN KEY 

RIGHT$ 

RIGHTS (expression I, expressi'on2) 

Returns a siring that consists of a number (expressions) of 
characters from a string {expression 1] starting from the right- 
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most characier in expression 1. Expressic)n2 musl be an integer 

between 1 and 255. 
— , If expressicin2 is tjreater than the length of expression 1, the 

RIGHTS fvmciion will redirn the entire siring. Yon can use the 

LEN Innc't ion to see how long expression 1 is. 

If ex]jression2 is zero, then RIGHTS returns the null string. A 

null string is a string with a length of zero. 
~ The LEFTS. MIDS. and RIGHTS string handling functions and 

, . the INSTR ftmetion can be vised to perform complicated string 

handling operations. 

_, Example: 

~ 10 TS = ■ BEGINNING.MIDDLE, AND END OFTEXT" 

_ 20 E5 = RIGHTS(TS,3):REM ES = 3 RIGHTMOST CHARS OF 

TS, 

— 30 IF ESO'END" THEN PRINT RIGHTS(AS,8) 

_ 40 REM CHECKS IF 3 RIGHTMOST CHARS = END; 

IF NOT, PRINTS 8 RIGHTMOST 

— RUN 

_ OF TEXT. 

RND 

RND (express/on) 

Returns a random number between and 1. Expression is the 
seed \'alue. 
Example: 

— 10 FOR A = 1 to5 

_, 20 PRINT INT (RND{X)*100) 

30 NEXT A 

— RUN 

24 30 31 51 5 



SGN 

SGN {expression) 

Returns a value that indicates whether the valtie of [expression] 
■ — ■ is positive, negative, or zero. The SGN function values are: 
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• ForX > 0. SGN rcluriis + 1 

• ForX = 0. SGN returns w 

• For X < 0. SGN relurns - 1 

Example: 

10 ON SGN(X; + 2 G0TO75, 125, 180 ^ 

20 REMIFX< GOEST0 75;IFX = GOEST0 125 .^ 
30 REMIFX >0 GOESTO 180 

SEV ^ 

SIN (expression) i^j 

Retiirns 1 he sine al' {cxpressioi]) in radians. , , 

Example: 

PRINTSIN(1.5) „ 
.997494987 

SPC _ 

SPC {expression] v / 

Prints the number of blank spaces on the screen (or printer, if ^_^ 
opened) indicated by the number in [expression]. SPC can only be 

used with I'HINT. E.xpression nuust be between and 155. "—^ 

Example: 

PRINT TOTAL SALES'; SPqi5);X ,_ 
TOTAL SALES 12345.67 

SQR ^ 

SQR (expression) , 

Returns I he square rool o!' [expression]. E.vpressinn must be ^_^ 
greater than or equal lo zero. 

Example: 

PRINT 10, 5QR(10) — 
10 3.16227766 



_ STATUS 

Status 

[■it'lurns a conipiclion STATUS for ihe lasl input /output opera- 
tion which was pcj-rornied on an open file. The STATUS can be 
read from an\' peripheral device. 
The value of the status function depends on the operation and 
^^ device checked. 
^ Use the STATUS function to: 

y-^ • check for errors during the ])rocessing of a program on disk 

• see if you are at the end of a file during the read processing 
^~^ • check on a veril\' operation 

"^ A table of STATUS code values for printer, disk (IEEE peripher- 
— . alsj and RS-232 l"ilc operations is shown below; 



ST Bit 
Position 


ST Numeric 
Volue 


IEEE 
Bus 


RS-232C 

Channel' 





1 


(ime out 
write 


parity error 
(receive only) 


1 


2 


time ouf 
read 


framing error 
(receive only) 


2 


4 




overrun 
(receive only) 


3 


8 






4 


16 




input buffer 
empty 


5 


32 


DCD error 


6 


64 


EOl 


D5R error 


7 


128 


device not 
present 



■Meaning when bit is sel to 1 . 

STR$ 

SIRS (express/on) 
Returns a string representation of the value of [expression] 

Example: 



— PRINT ■■$■■ + STRS(2.77) 



Prints S2.77 
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or 

PRINT-S"';STR5(2.77} Prints !32.77 

PRINT STRS(150) + ■'.OO' Prints 150.00 



TAB 

TAB {expression) 

Positions the cursor in the coliiinn represented by [expression). 
Yon can only use TAB with a PRINT statement. Expression must 
be between and 155. The first column on the screen Is column 0. 



Example: 



PRINT 'TOTAL"; TA8(29);"1 23456" 
TOTAL 123456 



TAN 

TAN {expression) 
Returns the tangent of [expression} in radians. 



Example: 



10 X = .785398163 
20 Y = TAN(X) 
30 PRINT Y 
RUN 



TI$ 

TIS 

Returns the internal inter^'al linier as a character string. The 
string contains seven characters showing hours, minutes, sec- 
onds, and tenths of .seconds (hhmmsst). Set the timer with this 
statement: 

10 TIS = ■QOOOOOO" 
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USR 

USR [expression] 

Calls (he user wriUen machine langua|:fe subroutine which has 
starting address stored in locations 3 and 4 of bank 15. The 
argument [expression] is stored in the floatingpoint accumulator 
prior to entering the subroutine. 



„ VAJL 



VAL 



express/on) 



RetLirns the numeric value of the string (expression). The STRS 
function performs the complementarv' task, numeric to string 
con\ersion. 

E.xam[ile: 

30 IF VAL(ZIPS)< 90000 OR VAL(ZIP$) >96699 THEN 
40 PRINT OUT OF STATE ■ 

RESERVED SYSTEM VARIABLES 



AND Logical operator. 

DSS Disk status reser\'ed word. 

EL Line number last error occurred. 

ER Error" of last error occurrence. 

OR Logical operator. 

NOT Logical operator. 



STatus 



TlSme 



The system status for the last Input /Output 
operation. 

The character string representation of the cur- 
rent time-of-day registers. 



RESERVED SYSTEM SYMBOLS 

+ Plus sign arithmetic addition or string concatenation 

- Minus sign arithmetic subtraction and unan' minus 

* Asterisk: arithmetic multiplication 

/ Slash: arithmetic division 
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(blank) Blank: separates ke\'\vords and \ai'iable names 

= Equal sij^n: vaJiic assignment and relationship testing; 

< Less than used in relationship testing 

> Greater than: used in relationshijj (esting 

I Up arrow: arithmetic e.\}50Mcntiaiion 

.Comma: used in \-ariabfe lists to formal oulpnt; also 

separates command parameters 

decimal ]Doint in lloating point constants 

used in \-ariable lists to format ontpiit 

separates multiple BASIC statements on a prn- 
t^ram line 



Period: 
Semicolon: 
: Colon: 



■ Quotation 

■ mark: encloses string constants 

? Question mark:abbreviaiion for the kcnvord PRINT 

( Left 

parenthesis: expression evaluation and functions 



) Hight 
parenthesis: 

%!'ercen(: 

" Xiunber: 

S Dollar sign: 
-Pi: 



expressifin evaluation and Uuietions 

declares a variable name as an integer 

comes before the logicai file niunber in input, 
output statements 

declares a \ariable name as a st ring 

the numeric constant 3. 14 159265 
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BASIC 4.0 
ABBREVIATIONS 



KEYWORD 



ABBREVIATION TYPE 



ABS 


a 


1>-J!II'^J 


B 


function — numeric 


APPEND 


a 


^iMM 


P 


statement 


ASC 


a 


KUlUi 


S 


function — numeric 


ATN 


a 


E^IUMJ 


T 


function — numeric 


BACKUP 


b 


ESMM 


A 


command 


BANK 


ba 


tMiM 


N 


statement 


BLOAD 


b 


tmiM 


L 


command 


BSA\^ 


b 


§MiM 


8 


command 


CHRS 


c 


^lUiU 


H 


function— string 


CATALOG 


c 


IfUlMj 


A 


command 


CLOSE 


cl 


KUJMl 


O 


statement 


CLR 


c 


^SMM 


L 


statement 


CMD 


c 


IdUUi 


M 


statement 


COLLECT 


CO 


msa 


L 


command 


CONCAT 


con 


ESSE 


C 


statement 


CONT 


c 


feUlliJ 


O 


command 


COPY 


CO 


fcUllij 


P 


command 


COS 


d 


none 


A 


llinct ion— numeric 


DATA 


fcUilikl 


statement 


DCLEAR 


d 


none 


C 


command 
statement 


DCLOSE 


i^uim 


DEFFN 


d 


IcUlMi 


E 


statement 


DELETE 


de 


tiill^i 


L 


command 


DIM 


d 


MMiM 


I 


statement 


DIRECTORY 


di 


iMiM 


R 


command 
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DISPOSE 


di 


KillUi 


s 


statement 


DLOAD 


d 


l£i;jMj 


L 


command 


DOPEN 


d 


^iMM 


O 


statement 


DSA\^; 


d 


E3SM 


s 


command 


END 


c 


ESSE 


N 


statement 


ERRS 


e 


none 


X 


function— strinf^ 


EXP 




function — numeric 


FOR 


r 


Idfllid 


o 


statement 


PRE 


1 


EdUMl 


R 


function— numeric 


GET 


M 


EdUlii 


E 


statement 


GET" 


go 


none 


S 


statement 


GOSUB 


I^UlliJ 


statement 


GOTO 


g 


i£mui 


o 


statement 


HEADER 


h 


IdUUl 


E 


command 


1F...GOTO 




none 




statement 


1E..THEN...ELSE 




none 




statement 


INPUT 


i 


none 


N 


statement 


INPUT" 


■.-iill^tJ 


statement 


INSTR 


in 


liilllil 


S 


function — numeric 


INT 


k 


none 


E 


function — numeric 


KEY 


Earn 


command 


LEFTS 


le 


IdlMi 


F 


function — string 


LEN 


1 


none 


E 


function — nimieric 


LET 


IslliliJ 


statement 


LIST 


1 


EdliUi 


I 


command 


LOAD 


1 


ESSSM 


O 


command 


LOG 


m 


none 


I 


function— numeric 


MIDS 


i^miij 


function — string 


NEW 


n 


none 


E 


command 


NEXT 


ESSl 


statement 


ON...GOSUB 




none 




statement 


0N...GOT0 


o 


none 


P 


statement 


OPEN 


IsUIMi 


statement 


PEEK 


P 


ESSM 


E 


lunct ion— numeric 


POKE 


P 


Essa 


O 


statement 


POS 




none 




function — numeric 


PRINT 


9 

P 




R 


statement 


PRINT" 


ESSM 


statement 


PRINT USING 


?us 


ESSiM 


1 


statement 


PUDEF 


r 


none 


E 


statement 


READ 


l^iUMJ 


statement 
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RECORD 


re 


tlllUi 


C 


statemenl 


REM 


re 


none 


N 


statement 


RENAME 


oaia 


command 


RESTORE 


re 


§MiM 


S 


statement 


RESUME 


res 


ESSSM 


u 


statement 


RETURN 


re 


^iniM 


T 


statement 


RIGHTS 


r 


t^iMM 


I 


function — string 


RND 


r 


■anrja 


N 


function — numeric 


RUN 


r 


idum 


u 


command 


SAVE 


s 


UHliM 


A 


command 


SCRATCH 


s 


feUllii 


C 


command 


SGN 


s 


KiiiiitJ 


G 


fu notion — nu meric 


SIN 


s 


■smiaa 


I 


function — numeric 


SPC 


s 


EdUiU 


P 


ftmction — special 


SQR 


s 


ESSSM 


Q 


function — ntmierlc 


STATUS 


St 

s 




T 


function — numeric 


STOP 


^iMM 


statement 


STRS 


St 


■Hill^J 


R 


function — string 


SYS 


s 


feUilil 


Y 


statement 


TAB 


t 


ElillMfl 


A 


function — special 


TAN 




none 




lunction — numeric 


TIS 


t 


none 


R 


function — string 


TF^P 


idjMi 


statement 


USR 


LI 


tMiM 


S 


funct ion — speciai 


VAL 


\' 


none 


E 


function — nimieric 


VERIFY 


g.H!ll;tJ 


command 


WAIT 


w 


§MiM 


A 


statement 



NOTEiThe ctitjracter printed is the same in normci (text) mode and graphics mode 
unless otherwise indicated. 
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APPENDIX C 



SCREEN DISPLAY 
CODES 



SET 1 


SET 2 


POKE 


SETl SET 2 


POKE 


SETl SET 2 POKE 


@ 







U u 


21 


^ 


42 


A 


a 


1 


V V 


22 


+ 


43 


8 


b 


2 


W w 


23 


, 


44 


C 


c 


3 


X X 


24 


- 


45 


D 


d 


4 


Y y 


25 




46 


E 


e 


5 


Z z 


26 


/ 


47 


F 


f 


6 


[ 


27 





48 


G 


g 


7 


£ 


28 


1 


49 


H 


h 


8 


1 


29 


2 


50 


1 


i 


9 


1 


30 


3 


51 


J 
K 
L 


i 

k 
1 


10 
11 
12 


— 


31 
32 
33 


4 
5 
6 


52 
53 
54 


Qjoai 


1 


M 


m 


13 


" 


34 


7 


55 


N 


n 


14 


# 


35 


8 


56 


O 


o 


15 


$ 


36 


9 


57 


P 


P 


16 


% 


37 




58 


Q 


q 


17 


& 


38 


; 


59 


R 


r 


18 


■ 


39 


< 


60 


S 


s 


19 


( 


40 


= 


61 


T 


t 


20 


) 


41 


> 


62 



114 APPENDIX C 



SETl 


SET 5 


POKE 


SETl SET 2 


POKE 


SET 1 SET 2 POKE 


7 




63 


71 u 


85 


T 


107 






64 


><^ V 


86 


N 


108 


♦ 


A 


65 


O w 


87 


l-- 


109 


1 


B 


66 


ffl X 


88 


b_ 


110 


h 


C 


67 


Y 


89 


^ 


in 


r 


D 


68 


If z 


90 


1 r 


112 




E 


69 


hH 


91 


j_ 


113 




F 


70 


^ 


92 


T 


114 




G 


71 




93 


H 


115 


1 


H 


72 


TTl fl! 


94 


U 


116 


^ 


1 


73 


a s 


95 


1 

1 — B 


117 




J 
K 


74 
75 


E^ai 


96 
97 


1 

n 


lie 

119 


1 


u 


L 


76 


y 


98 


r 


120 


N 


M 


77 


n 


99 


L 


121 


V\ 


N 


78 




100 


U S 


122 


n 


O 


79 


1 


101 


■ ! 


123 


n 


P 


80 


m 


102 


■ 


124 


m 


Q 


81 




103 


J 


125 




R 


82 


\gA 


104 


F 


126 


[v) 


S 


83 


r 9. 


105 


ft 


127 




T 


84 


J 


106 







Codes form 1 28-255 are reversed imoges of codes 0-1 27. 
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CH 


[Rj 


$CODE 








PRINTS 






PRINTS 




PRINTS CHRS 


PRINTS CHRS 


TEXT 


GRAPHICS 


CHRS 


TEXT 


GRAPHICS 


CHRS 





23 






46 


e 


E 


69 


1 


24 


/ 


/ 


47 


f 


F 


70 


2 


25 








48 


9 


G 


71 


3 

133 4 


26 


1 

2 


1 

2 


49 
50 


h 
1 


H 
1 


72 
73 


|i^27 


5 


28 


3 


3 


51 


i 


J 


74 


6 


29 


4 


4 


52 


k 


K 


75 


lilMll 7 


30 


5 


5 


53 


1 


L 


76 


8 


31 


6 
7 


6 
7 


54 
55 


m 
n 


M 
N 


77 
78 


UU 9 


l£LUsy32 


10 


! 33 


8 


8 


56 


o 


O 


79 


11 


34 


9 


9 


57 


P 


P 


80 


12 


n 35 

5 36 
% 37 

6 38 


< 


< 


58 
59 
60 
61 


q 

r 
s 
t 


Q 
R 
S 
T 


81 
82 
83 
84 


IMtiJ '^ 






- 


liH ^5 


16 


39 


> 


> 


62 


u 


U 


85 


mi ^7 


( 40 


? 


? 


63 


V 


V 


86 


ii 18 


) 4] 

42 

+ 43 


@ 
a 
b 


@ 
A 
B 


64 
65 
66 


w 

X 

y 


W 
X 
Y 


87 
88 
89 


EQIQ119 


Idd 20 


21 


44 


c 


C 


67 


z 


Z 


90 


22 


45 


d 


D 


68 


[ 


[ 


91 



NOTE: The choracler printed is llic some iii normal (text) mode and groptiics mode 
unless otherwise indicaled. 
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PRINTS 




F 


RINTS 




PRINTS 


CHRS 


PRINTS 


CHRS 


TEXT GRAPHICS 


CHRS 


TEXT 


GRAPHICS CHRS 


£ 


92 




148 


La 


172 


G 


' 


199 


IBSl 


1 


93 




149 


\^ 


173 


H 




200 


t 


94 




150 


b_ 


174 


1 


::^ 


201 


— 


95 




151 
152 


j: 


175 
176 


J 

K 




202 
203 


SEE NOTE 


BOTTOM 




153 


PC 


177 


1 


L 


204 


OF PAGE 






154 
155 


li 


178 

179 


M 
N 




205 
206 




128 




129 




156 


c 


80 


O 


c 


207 




130 
131 
132 
133 
134 




157 
158 
159 
160 
161 


in 

n 
u 


181 
82 
83 
84 
85 


P 

Q 
R 
S 

T 


1 

m 

1 
1 


208 
209 
210 
211 

212 


EQEl 






iB^aa 


c 




135 


B 


162 


v □ 


86 


U 


.^ 


213 




136 

137 


n 


163 
164 


■ 

[3 


87 
88 


V 

w 


o 


214 
215 


g^lil 




138 


~i 


165 


E 


89 


X 


1^1 


216 




139 
140 


m 


166 


r 
s 

A !♦! 

B 1 

C ^ 1 


90 
91 


Y 
Z 


m 
ifi 
yd 
ij 


217 
218 


PRINTS 




asiiiMM lil^iUiUl 


14I 

142 

11 '13 


TEXT GRAPHICS 


CHRS 


V2 
93 
Q-l 




219 
220 
221 
222 


1 SWITCH TO 
1 GRAPHICS MODE 




n 


167 


WHUhUWtlUMbV. 




144 


168 


95 


_ 


ma 


145 
146 


2 r 


169 
170 


D 1 

E ^ 1 


96 
97 


g^ 


ri 


223 


SEE NOTE 


QEI 


147 


IE 


171 


F E ^ 


98 


BOTTOM 
OF PAGE 



CODES 96-127 
CODES 224254 
CODE 255 



ARE THE SAME AS 32-63 
ARE THE SAME AS 160-190 
IS THE SAME AS 222 



APPENDIX D 117 



APPENDIX £ 

SCREEN MEMORY MAP 



Your conipiUer's memory 
stores the characters currently 
displayed on the screen and 
automatically updates changes. 
Your 'B' Series computer screen 
has 25 tines by 80 columns, so 
it has positions for 2000 char- 
acters. Each of 1 hese positions 
has its own screen memon,' 
address by which you can refer 
to (he screen position and the 
character currently located 
there. You can access a specihc 
location by supplying the 
address in PEEK and POKE 
statements, PEEKs let you see 
what is in a screen memory 
location, and POKEs let you 
put a value into a screen 
memop,' location. 

Each character position is 
represented by one byte, start- 
ing at hexadecimal address 
DOOO (decimal 53248) and 
cndingat hexadecimal address 
D7CF (decimal 55247). 
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B SERIES MEMORY MAP 



B Scries Memory Map B Scries Memory Map 

SegmentiOl fo04 SegmentOF 

r SFfFf 



B Series Memory Map 
I/O Addreti Block 



50002 
SOOOl 
500OT 



INDlBfCr SEGMENT BANK 



EXEC SEGMt'JI BANK 



' 






SD'QO 
SDECO 
SOOCO 


e;;r- ■.faCABD 




<rRNAl ROM 




6535 itt£ AEB 


SEOOO 


655' BS232 







6536 IEEE JBB'UStBPORT 






EnTfOBI O.. Co proCeiiO- board: 






65Si iSOUNDGENEeAIOBi 




BASIC 80« 




DISK UNITS 




tSiS CBl CONTROlLEB 














BASIC BOV 








S8C00 








3K SCBEEN 
HAM 






CAftTfitDOf fiOV.'PAM 1 






S40OO 








CaBTBiDGE «0«-»Aw 1 






SlDOO 






SCC'OO 




CABTRICGf fiOM'BAM 


















JK DISK BOM 






NOT USED 


SIOCO 
SORDO 
50002 
!003t 
ioom 






sccoo 




2K E«T BUfFEBBAM 




3K DAW 
INOl«[CtSEGMENt BANK 


f«£C SEGMENT BANK 
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APPENDIX G 



MATHEIHATICAL 
FUNCTIONS TABLE 



FUNCTION 

secant 
cosecant 
coiaiifieiit 
iii\ersc sine 
iii\'fise cosine 

invcrst" secani 
inwrsc coscrant 

inverse cotangent 
hxiJcrbolic sine 
liypcrtjolic engine 
liV|H'i't>i)li(' laiifienl 

h\pcibo[ic sfcaiu 
h\pcrbolic cosccani 
I"iv-|)crl5(ilic ciilanticnt 

inverse Inperbolie sine 
iiiv'ci'se hviierbolie cosine 
iin'crsc h>i)erbolic tangent 
inverse h\perholic secant 

inverse inperboiic cosecant 

inverse hyperbolic coniarigeiit 



BASIC EQUIVALENT 

secfxl = 1 /cosl.v) 

csclx) = 1 /sintxl 

cottx) = 1 /tanix) 

arcsln(xl = atnl.\/s(|r( - x'x + 1)1 

arccos(x) = -atn(x /sqrf -x*x + 11) 

+ -/2 
arcseeixl - ainix /sqrtv'x 1)1 
art'csclx) = atn(x /scjrix'x 1)1 

+ isijnix} ir-za 

areotlx) = ainlxl + - /2 
sinh(x) = lexp(x) - cxpl x)) /2 
coshixl = (explxl + expl-xll/2 
lanhlxl = exi)l-x| / 

lexplxj T expl xl)*2 + I 
seeblxl = 2/lexp(x) + cxpt x)) 
esclitxl - 2/(exp(x) - exi)( x)l 
cotli(x) = exp( x) , 

lexi)lxl - exp(-xl)*2 + 1 
arcsinhlx) - loglx ^ sqrfx'x + 1)1 
areeoshlxl = loglx - sqrlx'x - 1)1 
arctanhlx) = lng((l + x)/(l - x)1.2 
arcscrhlxl = lngl(sqrl-x*x + II 

+ D'xl 
arecscbtxl - logKsgnlxr 

.sqrlx'x + 1 /x] 
arccolb(x) = logdx + 1) (x - 1 11 .2 
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APPENDIX H 



PINOUTS FOR 

INPUT /OUTPUT 

DEVICES 



Your computer is equipped with several specialized chips all in 

BANK 1 5. The 6526 Complex Interface Adapter is located at 56320 
(SDC:00). The 6551 Asynchronous Communications Interface 
Adapter is located at 56576 (SDDOO). Your compuicr has two 
6525 Tri-port Interface chips located at 56832 (SDEOO) and 
57088 (SDFOO). For more information, consult your Programmer's 
Reference Guide. 



1 






3 






3 






4 






5 






A 






7 






a 






<> 






10 






11 






1? 






1.) 






14 






15 







Connector Pin— Outs 



Pin 


Typo 


Pin 


Type 




1 


*o 


A 


BDD 








S 


BDI 




3 


A2 


c 


BD! 




4 


A3 


D 


BD3 




5 


A4 


f 


BD4 




6 


A5 


F 


BD5 




7 


A6 


H 


BD6 




8 


A7 


1 


BD7 




9 


A8 


K 


GND 




10 


A9 


1 


GND 




11 


AlO 


M 


SR/W 




t? 


All 


N 


502 




13 


Al? 


P 


NOT CSBoMk 1 




u 


■ 5 vnc 


f 


NOT CSBur.k ? 




'5 


■5 vnc 


s 


NOT C5B„r,l 3 





14 




.^ 


l*. 


n 


U 


16 


o 





\7 


o 


"^ 


18 


Q 


" 


19 


n 


o 


20 


o 


Q 


21 


o 


O 


?? 


a 


o 


?T 


f) 


o 


?A 


D 


a 


35 




•^^ 



Ke 


yboard Conne 


Ctor 


Pin 


Type 


Pin 


Type 


1 


PAO 


3 


PA2 


3 


PAa 


4 


PA* 


5 


PflO 


6 


FBI 


7 


PB3 


S 


PB3 


9 


PB4 


10 


PBJ 


11 


PB6 


13 


pa? 


13 


PCS 


!4 


PAI 


15 


PA3 


16 


PAS 


17 


Pa7 


IS 


PCD 


19 


PCI 


30 


PCI 


31 


PC3 


33 


GND 


23 


GNO 


34 


GND 


35 


PC4 







RS232C Connector 



14 


(^ 


o 


!•) 


r, 


'"^ 


lis 


^ 


o 


17 


a 





18 


•> 


'"' 


ly 


n 


" 


20 


O 


^ 


31 


o 


o 


37 


O 


o 


73 








/i 






35 


"^ 


□ 



Pin 


Type 


1 


SHIfLD 


3 


T >.D 


3 


B «D 


4 


RTS 


5 


CTS 


6 


DSR 


7 


GND 


8 


DCD 


11 


-5V0C 


IB 


12 VDC 


30 


DTR 


34 


R • C 



All oilier; N.C. 
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20 1 
It 

?6 I 



User Connector 



3 
5 
7 
19 
1 I 
13 
15 
17 
19 
21 
33 
?5 



Pi.l TyOt 


P.n T,,,,. 


1 GND 


2 PB3 


3 GND 


3 PB3 


S MOT PC 


6 NOIfLAG 


7 3D7 


8 2D6 


9 IDS 


10 3D4 


11 7D3 


12 


3d; 


13 IDl 


U 


3D0 


1 5 1 D7 


16 


1D6 


17 IDS 


18 


1D4 


19 1D3 


20 


1D3 


;i IDl 


3? 


IW 


?3 . NOT CNT 


3J -SVDC 


?5 NOT IRQ 


36 5P 



IEEE Connector 



I 

2 

3 

It 

I 5 

16 



Pin 


Type 


Pin 


Type 


1 


01 


A 


OS 


3 


02 


B 


D6 


3 


03 


c 


D7 


4 


04 


D 


OB 


5 


EOl 


E 


REN 


6 


DAV 


F 


GND 


7 


NRPD 


H 


GNO 


B 


ndac 


J 


GND 


9 


IFC 


K 


GND 


10 


SRQ 


I 


GND 


11 


AIN 


M 


GND 


1? 


SHIfLD 


N 


GND 



Co-Processor Connector 



Pin 


Type 


Pin 


Type 


1 


tXTMA3 


■7 


DRAMOO 


3 


EXTMA2 


4 


DRAMOl 


5 


EXTMA7 


6 


DRAM02 


7 


EXTMA6 


8 


DRAM03 


9 


EXIMA5 


10 


DRAMOi 


11 


EXTMA4 


12 


D RAMOS 


13 


[XTMAl 


14 


DRAM0« 


IS 


EXTMAO 


16 


DRAM07 


17 


GND 


18 


GND 


19 


GNO 


20 


GND 


21 


GNO 


22 


NOT BUSYl 


23 


GND 


24 


NOT P2REFREQ 


25 


GND 


26 


NOTP2BEFGRNT 


37 


GND 


39 


BPO 


29 


GND 


30 


BPl 


31 


GND 


32 


BP2 


33 


NC 


34 


BP3 


35 


NOT PR0CRE5 


36 


NOT BU5Y2 


37 


EXTBUfB/V/ 


38 


NOT ERAS 


39 


DRAMii'-W 


JQ 


NOT EGAS 
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Expansion Connector 



I 


o 


o 


2 


J 


o 


o 


4 


5 





o 


6 


7 





o 


8 


9 





o 


10 


11 


□ 


D 


13 


U 


Q 


O 


14 


15 


o 


O 


16 


17 


Q 


n 


IB 


19 


O 


D 


20 


21 





O 


22 


23 


o 


o 


24 


25 


o 





26 


27 


o 


o 


28 


29 


o 


o 


30 


31 


o 


o 


3? 


33 


o 


o 


34 


35 





o 


36 


37 


o 


n 


38 


3y 


o 


o 


40 


.It 


a 


o 


42 


■S3 


o 





44 


.16 


o 


o 


46 


47 


a 


o 


46 


■19 


o 





50 


51 


o 


o 


52 


S3 


o 


o 


54 


55 


o 


o 


56 


57 





o 


58 


59 


n 


o 


60 



Pin 


Type 


Pin 


Type 


1 


■5 VDC 


2 


'5 VDC 


3 


•5 VDC 


4 


15 VDC 


5 


GND 


6 


GND 


7 


GND 


8 


GND 


9 


GND 


10 


GND 


11 


NOT Bf AS 


12 


IR03 


13 


!?VDC 


14 


NOT EXTRES 


15 


■12VDC 


16 


NO! S 


17 


NOT RES 


18 


LPEN 


19 


SR/W 


30 


NOT [XTBUFCS 


21 


TODCU 


22 


NOT DISKROMCS 


23 


BOOICIK 


2-1 


NC 


25 


so; 


26 


NOT BCAS 


7? 


so: 


28 


NOTCSl 


79 


BD3 


30 


NOT EXTPRTCS 


31 


BD-I 


32 


BD2 


33 


605 


34 


BDl 


35 


DB7 


36 


BDO 


37 


BA13 


38 


BD7 


39 


BAU 


40 


BAl 5 


41 


BA) 


42 


RAO 


13 


ba; 


44 


RAl 1 


45 


BA3 


46 


BAlQ 


47 


BAl? 


4B 


BA4 


49 


aA9 


50 


BA5 


51 


BA8 


5! 


BA6 


53 


3P0 


54 


8A7 


55 


BPl 


56 


BP2 


57 


NOT NMl 


58 


BP3 


59 


? r V 


60 


NO I IRQ 



Audio Jack 



Pin 


Type 


1 
2 
3 


TO SPLAKLK 

N.C. 

10 SPEAKER 



Power Connector 



Pin 


Type 


1 


50/60 Hz 


7 


-12VDC 


3 


-12VDC 


A 


GND 


5 


GND 


6 


■ ') VDC 



Video Connector 



Pin 


Type 


] 


VIDEO 


2 


GND 


3 


VERTICAL SYNC 


4 


GND 


5 


HORIZONTAL SYNC 


6 


KEY 


' 


GND 



Reset Connector 



Pin 


Type 


1 
2 


TO RESET SWITCH 
TO RESET SWITCH 
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CONVERTING FROM 

STANDARD BASIC TO 

EXTENDED BASIC 4.0 



If you have prosrams wriitcn in a BASIC other than Commodore 
BASIC, some minor adjustments may be necessau' before run- 
ning I hem with Commodore BASIC. Here arc some speeifir (hin.tfs 
to look for when converting BASIC programs. 

String Dimensions 

Delete all siatement.s thai arc used to declare ihe length of 
strings. A statement such as DIM AS(I. J), which dimensions a 
siring array for J elements of length I. should be converted to the 
Commodore BASIC statement DIM ASU). 

Some BASICS use a comma or ampersand for si ring concatena 
(ion. ICach of these must be changed to a pltis sign, which is the 
operator for Commodore BASIC siring concatenation. 

In Commodore BASIC. theMlDS. RIGHTS, and LEFVS I'unclions 
are used to take substrings of strings. Forms such as ASd) to 
access the "Ith" character in AS. or AS(I. J) to lake a substring of 
AS from position I lo position J. must be changed as follows: 

Other basic: Commodore BASIC 

A$(l) = XS AS = LEFTS(AS,I - 1 ) + XS + MIDS(AS, I + 1) 

A$(I,J) = XS AS = LEFTS(AS,I - 1 ) + XS + MIDS(AS,J + 1) 



Multiple Assignments 

Some BASICS allow statements of the form: 

10 LET B = C = 
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to sel B and C equaJ )o zero. Commodore BASIC would inierpret 
(he second equal sign as a lo/^icaJ operator and sel B equal (o - 1 if 
C equaled 0. Instead, converl this siatement lo two assignment 

statements: 

IOC = 0:B = 



Multiple Statements 

Some BASICS use a backslash to separate multiple statements 

— on a line. With Commodore BASIC, be sure all statements on a line 
_^ are separated b\- a colon. 

•^ MAT Functions 

— Programs using the MAT functions available in some BASICs 
_ must be rewritten using FOR . . . NEXT loops to execute properly. 

Dl£Ferences From Older Commodore BASIC 

— TI references must be changed. The current smallest unit of 
_^ time is 1 /lO sec. rather than 1 /60 sec. TIS now has seven charac- 
ters instead of si.x. The seventh character is tenths of seconds. ER 

— , is now a reser\'ed variable. All references must be changed to use a 

_^ new variable name. ER returns the error number ( 127 is no error). 

EL is now a reserved variable. All references must be changed to 

_ use a new variable name. EL returns the line number of the last 

error (65535 is no error). 
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ERROR MESSAGES 



# MESSAGE EXPLANATION 

?stop key detected Occurs when doing a KERNAL I /O 

function and the STOP key is 
pressed. May occur during LOAD 
or SAVE (or'OPEN. CLOSE. GET*. 
INPUT*'. PRINT**). Disk files are not 
damaged. 

1 . ?too many fries You are lr>'ing to OPEN more than 

10 files at a time. Decrease the 
number of OPEN or DOPEN files by 
CLOSING them. 

2. ?fi!eopen An attempt was made to redefine 

file parameter information by 
repeating an OPEN command on 
the same file twice. 

3. ?file not open The operating system must have 

information provided by the OPEN 
statement. If an attempt is made to 
read or write a file without having 
done this previously, then this 
message appears. 

4. ?file not found The named file specified in OPEN 

or LOAD was not found on the 
device specilied. 
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5. ?device not present No device on the IEEE was present 

"^ to handshake an attention 

_^ sequence. May happen on OPEN. 

CLOSE, CMD, INPUT". GET*. 
"^ PRINT*. If filename is not specified 

_, with OPEN, this error will not 

occur. 

^^ 8. ?missmg filename LOADs and SAVEs from the IEEE 

port (e.g.. the disk) require a file- 
^ name to be specified. Supply the 

_^ filename. 

^ 9. ?illegal 

_ device number Occurs if you try to access a device 

in an illegal manner. For example. 
~~ LOADing or SAVING on the key- 

_ board, screen, or RS-232. 

^^ 10. are you sure? This is a prompt for BACKUP. 

__ SCRATCH, and HEADER. It is not 

an error message and should not 
-^ occur during BASIC program 
execution. 

— ll,?boddisk Media failure on HEADER 
command, 

— 14. break This occurs when the STOP key is 
_^ pressed during normal BASIC exe- 
cution. The CONTinue command 

— ' can be used to restart the program. 

15. extra ignored Too many items of data or separa- 

-^ tors (.) were typed in response to an 

^^ INPUT statement. Only the first few 

items were accepted. 

_^ 16. redo from start Is not actually a fatal error printed 

in the standard format but Is a 
^ diagnostic which is printed when 
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data in response in INPUT is ikid 
nLiiiicricwhcrea numeric quatUity 
is required. The INPUT continues 
to I'unction until acceptable data 
has been rccei\ed. 

20. ?next without for Either a NEXT is improperly nested 

or the variable in a NEXT state- 
ment corresponds to no previously 
executed FOR statement. 

21 . ?syntox error BASIC cannot recognize the state- 

ment you have typed. Cai-ised by 
such things as missing parenthe- 
ses, illegal characters, incorrect 
punctuation, misspelled kcNWord. 



22. ?return ' — 

without gosub A RETURN statement was encoun- 
tered without a previous GOSUB ~ 
statement being executed. _ 

23. ?outofdata A READ staiemcnl was executed — 

but all of the data statements in _ 
tlic program ha\'e been read. The 

program tried to read too much — 

data, or insufficient data was in- 

eluded in the j^rogram. Carriage 

returning through a line READY ■ 

on 1 he B Series video display yields _, 
this error because the message is 

interpreted as RF:AD Y. — 



24. illegal quantity Occurs when a function is accessed 

with a parameter out of range 
caused by: 



1. A matrix subscript out of 

range (0 < X < 32767) 
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2. LOG I negative or zero argu- 
ment) 

3. SQR (negative argument) 

4. AtB where A < and B not 
integer. 

5. Call of USR before macliine 
language subroutine has been 
patchied in. 

6. Use of string functions MIDS, 
LEFTS. I^IGHT.S. with length 
parameters out of range (1 < X 
<255). 

7. Index ON . . . GOTO out of 
range. 

8. Addresses specified for PEEK. 
POKE. WAIT, and SYS ou( of 
range ( 1 < X < 255). 

9. Byte parameters of WAIT. 
POKE. TAB and SFC out of 
range (0 < X < 255). 



25. overflow Numbers resulting from computa- 
tions or input that are larger than 
— ' binan- 1.70141 184E + 38 cannot 
__ be represented In BASlCs number 

format. Underflow is not a delecta- 
-^ blc error but numbers less than 

_^ binaiA' 2.93873587E-39 are indis- 

tinguishable from zero. 

^ 26. ?out of memory May appear while entering or edit- 

ing a program as the text completelv 
fills memory. At run lime, assign- 

^^ menl and creation of variables may 

also fill all variable memor\^ Array 

— • a\'ailable declarat ions consume large 

_^ areas of nicmoiy even though a pro- 

gram may be rather short. The 

f^ maximum number of FOR loojxs 
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and simultaneous GOSUHs are 
dependent on each other. This con- 
text is stored on the mirro[)roces- 
sor hardware stack whose cajiacily 
may be exceeded. To delerniine the 
ty])c of riiemon- error, examine the 
results of FRE. If there is a large 
number of bytes available, il is most 
likely a FOR-NEXT or GOSUI3 prob- 
lem. A subroutine whicli lermin- 
ales in GOTO rather than RETURN 
wilt eventually cause an otit of 
inemori' error as stack pointers 
build up. 

27.?undefined 

statement An attempt was made to GOTO. 

GOSUB. or THEN (o a statement 
which does not e.\ist. 

28. ?bad subscript An attempt was made to reference 

a matrix element which is outside 
(he dimensions of the matrix. This 
may happen by specifying (he 
wrong nimitacr of dimensions or a 
subscript larger than specified in 
(he original dimension. 

29. ?redim'd array After an array was dimensioned. 

another dimension statement for 
(he same array was encounlered. 
For example, an array \'ariatale is 
defined by default when it is I'irst 
u.sed. and later a DIM statement is 
encountered. 

30. ?divisio[i by zei"o Zero as a divisor would result in 

niuneric overnow-thus it is not 
allowed. When this iivcssagc 
appears, it is most expcdicnl to list 
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the statement and look for division 
^^ operators. 

31. ?iflegal direct A single butler area is used by 

BASIC to process incoming char 
— - acters. This same buffer is iised to 

hold a statement that is being 
"" interpreted in direct mode. INPUT 

^—^ will not work because incoming 

characters would cn'erwrilc the var- 
^ iabie list following INPUT to be pro- 

— - cessed. DEF cannot be used in 

direct mode for a dilTerent but sim- 
*^ ilar reason. The name of a function 

— s is stored in (he BASIC varicXble area 

vvith pointers to the string of char- 

^ acters which define the function. 

— V Since the function exists only in 

the in[ju[ buffer, it is wiped out the 
*~" first time a NEW command is i\ped 

—, in. 

32. ?type mismatch The left-hand side of an assignment 
— ^ statement was a numeric \ariable 
_^ and the righl-liand side was a 

string, or vice versa: or a function 
-^ which expected a string argument 

was given a numeric one. or vice 
versa. 

33. ?stiing too long At tempi by tise of I he concatena- 
tion operator to create a string 
■ ^ more than 255 characters long. 

34. ?file data Occurs when an INPUT*' statement 
' finds a string while attempting to 

, read a numeric value. 

35. ?formuia 

— too complex This indicates that BASIC has run 

APPENDIX J 13T 



out of string temporar\- pointers to 

keep track of substrings in evaluat- . 

ing a string expression. Break the 

string expression into (wo smaller ~^ 
parts to cure the problem. 

37. ?undefined '"^ 

function Reference was made to a user __ 

defined function which had ne\'er 

been defined. — ' 

39. ?verify error The contents of memorv and a 

specified file do not compare. — 

40. ?out of stack Too many levels of FOR ... NEXT or 

GOSUBs have been executed. No — 

recovery possible. ^ , 

41 . ?unable to resume A fatal error has occurred, such as — ' 

running out of stack. ,_ 

42. ?unable to dispose All of the DISPOSE t^^pe items have ~' 

been disposed of or none exist. .^_, 

43. ?out of text Ifany LOAD or DLOAD exceeds the — 

end of the text bank of (64K) this _ 
error will result. This error will not 

occur when using the BLOAD — 
command. 

44. ?cannot continue The CONT command will not work — 

because the program was never __ 
RUN. there has been an error, or a 
line has been edited. 
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NONERROR 
MESSAGES 



llie messages listed below are a\'allable through the ERROR 
MESSAGE code numbers by using the ERRS calling codes listed 
next to each message. However, these messages are not Error 
Messages so they will not appear on the screen unless you specif- 
ically call for them in your programming or call for them as a 
standard operating procedure. 



MESSAGE 

12, (carriage return) ready 

(carriage return) 

13. (space) in (space) 

17. your last "evaluated 
number 



EXPLANATION 

This message lets you know tliai 
your system is ready to use. 

This message is similar to ready. 

This is the last number that has 
been evaluated through the num- 
erical output buffer, (e.g.. print 
10*10: if you use an ERS code 17, 
the number on your screen will 
equal the last evaluation — in this 
case, 100.) 



18. more (carriage return) 

1 9. [>ower on message 



*COMMODORE EiASIC 128. V4.0*** 



*COMMO!X')RE BASIC 256. V4.0* 
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6581 (SID) CHIP 
RCGISTER MAP 



The 6581 Sound Inierface Device is located starting at location '^ 

55808 (SDAOO). Below is a brief register map. For detailed infor- _ 
matlon, consult the ProgTammefs Reference Guide. 

zzzzSzz zzzzzzz Izzzzzz ZZZZ zzzz 

ooooooo ococooc ooooooo 0000 oooo ^ — ' 



sssssss sssssss sssssss ssss 

« ^ : Si; 

S f. c I „ 



z „ O 



Is'o — — *> n — '^ o ^ ~ 



< 5 1 2 i it E s : t :- > 

Q = p p g z 



Q 


- 


. 


i 


i 

a. 


1 §° 


2° 


Q 


- ■ .1 w 


LJ 


( 


□ 


- 


: 


i 


i 


w2 


f- 

S 


s 


a 


^- 


- 


i 


i 




n 


6 


-• 


- 


1 




^Ni, 


Q 


-' 




1 




^N 


a 


- 


J 


i 




^jil 


a 


- 


i 


i 







"-°^' 


i 


i 


< 


§ 




-■ 


- 


i 


i 


z 






_■ 


- 


ill 


i 


■— ■ 


l/'' 


- 


_ 


iii' 


t? 


^ 


"* 


A^i 




s 


^ 
< 




hi 




^: 




-iii 'g--' 


" " - , i , ■' 



- - i 


i 


5 df 

CO" 


a. 


i 


z £ i 
5 c « 


-'^i'i 






s 


^ ^J i 


-■ -' i 




$11 


^ si 




^ii 


^2\i 






' .' ■■ S ^ ^ 



:^ ^" = o J £ o ^ 

■ .1'''- - - . 

iJ s' = 5 i£6- 

ii I o si 6 - 

iJ'g t i £ a '^ 

^it iid- 

- s ° s £ d - 






4 = - -J - 
< = = — 

lA 

«<■= = = = 

a 
< 
•i = = = = 

^ o o ^ a 
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PRINTER COnnHANDS 



6400 Word Processor Printer/ 
8023P CBM Bi-DirecUonal Printer 

COMMAND SYNTAX FUNCTION 

OPEN OPEN !fn,cln,(sa) seis correspondence between 

file number and physical de- 
vice. The Ifn or logical file 
number may be any luimber 
from ] to 255. The dn or device 
ntmiber refers to the de\'ice 
yon wish to setid the lllc to. 
The sa or secoridar\' address 
alerts the [Driniers micropro- 
cessor system thai formalting 
is (o occur. 

CMD CMD Ifn transfers control IVom compu- 

ter to printer. The Ifn must be 
the same as that in the OPEN 
statement- Wlien you give the 
CMD command, the [>rinter 
prints READY and is awaiting 
further commands. The CMD 
command followed by a PRINT 
or LIST command directs the 
output to the printer. 

PRINTS PRINTS Ifn, data PRINT-^ works like PRINT ex- 

cept that output is directed to 
the printer instead of video. 
Using the CMD command 
opens a "listening" channel to 
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the printer, and when Ibllowed 
by a PRINT" command, the con- 
neclion between the printer 
and comjmter is shut down or 
is said to be "unlisteniiif^". 



CLOSE CLOSE Ifn 



Yon should always close a file 
after printing from it. Yon may 
not exceed ten open files so 
you should close files when 
von are finished with them. 
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USING THE 
RS-232C CHANNEL 



The OPfiN stalemenl for an RS-232C channel has some Hpecial 
argumeiils (hat you musl understand before you can use it. You 
must match the operating parameters of the RS-232C interface to 
those of the device youYe connecting to the computer. 

Wlien you open (he RS 232C channel, your OPEN stalemenl 
must look like this: 

OPEN filenumber. 2, secondary -address, openstring 
Wliere: 

Jilenumber is the logical file number to be associated with the 
RS-232C channel. 

secondani address delermincs die direction of the RS-232C 
channel. It can be injuit. output, or bidirectional and may or 
may no( convert between CBM and ASCII character codes. 

openstring is a fonr-bijte command string that establishes the 
operating jiarameters for the RS-232C channel. 

The secondanj-addrcss mav take anv of the values shown in 
Table 8.1. 

TABLE 8.1 RS-232C DIRECTIONAL 
SECONDARY ADDRESSES 

VALUE MEANING 

1 open an output channel 

2 open an injjut channel 

3 open an input /output channel 
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129 open an ouiput channel and convert CBM and ASCII 
character codes 

130 open an input channel and con\'err ASCII to CBM 
character codes 

131 open an input /output channel and convert between 
CBM and ASCII character codes 



The secandcini address values 1. 2. and 3 do not perlonn char 
acler conversions. 1 f you're ^ettinf* ASCII character codes through 
the RS-232C' channel. I hey are delivered as-is lo your (sro^ram. IT 
vou wan! CBM .'ASCII conversion you must select a sfconcian/- 
address \-aIue of 1 29. 1 30. Or 131. 



NOTE: If you are transmitting or receiving non-character data through your 
RS-232C interface, do NOT request CBM/ ASCII character conversion. This 
will completely scramble your data. 



The opensiriiig for i he RS-232C: interface is lour bytes long. The 
finsi two bytes contain detailed control inlbrmafion. The lasi two 
arcn'l used, bui vou must include them. 
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m [6] [5] m 



STOP BITS- 



0-1 STOP BIT 
M STOP BITS 
8 BIT PARITY 
M. 5 STOP BITS 
5 BIT NO PARITY 
1-2 STOP BITS 
ALL OTHER 
PAGES 

WORD LENGTH- 



BIT 


DATA 
WORD LENGTH 


6 


5 








8 BITS 





1 


7 BITS 


1 





6 BITS 


1 


1 


5 BITS 



RECEIVE CLOCK 



- EXTERNAL 

1 = INTERNAL 



H 


m 


n 


m 


BAUD RATE 











, 1'16 EXTERNAL 











1 


50 BAUD 













75 










1 ] no 





1 








134.5 





1 





1 


150 





1 







300 





1 




? 


600 












1200 









1 


(1800) 












2400 









i 


3600 




1 








4800 




1 





1 


7200 




1 







9600 




1 




1 ' 19200 



First Byte Open String 
RS-232C 
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PARITY OPTIONS- 



BIT 

7 


BIT 

6 


BIT 
5 


OPERATIONS 


- 


- 





PARITY DISABLED, NONE 
GENERATED/RECEIVED 








1 


ODD PARITY 
RECEIVER/TRANSMITTER 





1 


1 


EVEN PARITY 
RECEIVER/TRANSMITTER 


1 





1 


MARK TRANSMITTED 
PARITY CHECK DISABLED 


1 


1 ^ 1 


SPACE TRANSMITTED 
PARITY CHECK DISABLED 



ECHO- 



NORMAL 

ECHO 



UNUSED- 
UNUSED - 
UNUSED- 

UNUSED- 



Second Byte Open String 
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MACHINB LANGUAGE 

MONITOR 



TIM is ihcTerminal [[iterlacc Monitor program for MOS Tcchnoi- 
ot^vs 6500 Series microprocessors. It has been expanded and 
adapted to liinction on the B Series computers. Execution is 
transferred from the CBM BASIC interpreter to TIM by the SYS 
command. The monitor is incorporated as part of the Keriial. 

Commands typed on the CBM keyboard can direct the TIM (o 
start e-vecuting a program, displax' or modifv registers and mem- 
or\- locations, load or save binarv- data, view other segments, send 
disk commands or read status, set default disk unit and load and 
execute programs by entering the program name (Segment 15 
only). On modilying memoty, TIM NO LONGER perlorms auto- 
matic read alter write verification to insure that the addressed 
memorv' exists, and is R AV t>TDe. 



-^ TIM COMMANDS 



M 


Display memory 




Alter memoiA' 


R 


Display registers 




Alter registers 


G 


Begin execution 


L 


Load 


S 


Save 


V 


View Segment 


u 


Set default disk unit 


& 


Send disk command or get disk status 


X 


Exit to basic 


z 


Transfer to second microprocessor 



<file name> load and execute 
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EXAMPLES 



M DISPLAY MEMORY 

M 0000 0010 

: 0000 Of Of 4c d9 9a 00 00 00 00 00 00 00 22 22 9e GO 

: 0010 00 GO 00 00 00 00 00 d4 fb 04 00 04 00 00 c4 fb 



In a display memon' command, tfie start and endinj^ addresses 
must be c-omplclely specified as 4 digit hex niinibera. To alter a 
memor>' location, move the cursor up in the display, type the cor- 
rection and press |i|^|HI:l« t o enter th e change. When you move 
the cursor lo aline and press |iaH22i. the colon tells the monitor 
thai you are re entering data. 

R DISPLAY REGISTERS 
R 

PC IRQ SR AC XR YR SP 

;0007 FBF8 BO DD 71 04 71 

The registers are saved and restored upon each entiy or e.xit 
from the TIM. They may be modified or preloaded as in the display 
memor\- example above. The semicolon tells the monitor you are 
modifying the registers. 

G BEGIN EXECUTION 
G0200 

The GO command may have an optional address for the target. 
If none is specified, the PC from the R command is taken as the 
target. 

L LOAD 

L "filename , OB 

No defaults are allowed on a load command. The dc\ice ntnuber 
and the file name niiisl becornpleiely specified. Operating system 
|)roinpls for operator intenrnlion are the same as for BASIC". 
Memor\- addresses are loaded as specified in the file header which 
is set up toy the SA\-Tv command. Machine language subroutines 
may be loaded from BASIC bin care must f.?e taken not !o use 
BASIC variables as the variable |)ohiler is set to the last byte loa- 
ded + 1. The niacliine language subroutine will be loaded nilo 
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__ the segment that you are currently in as delermined by the V 
command. After the load, the system will be initialized back to 

— segment 15. 

"^ S SAVE 

— S ■f//ename",08,010200,010300 

^^ As in the load command, no defaults are allowed in the SAVE 

^-\ command. The device nimiber. file name and a six byte start and 
end address mtist be .£fi\'en. The above example will sa\'e a program 
to device 8 from segment *1 starting at 0200 hex and ending at 

/—> 0300 hex. The first two bytes are the segment number followed by 
• he address. Valid segment bytes may be and OF depending on 
your memorv'. After a save, the system will be initialized back to 

— • segment 15. 

~ V VIEW 

— vol 

This will change the segment to the one that you wish to view. 

— sa\'c. load or change memor\' from. The \'alid segments are 00 to 
-. OF 

— . U UNIT ADDRESS 

_ U09 

— This command will allow you to set the disk unit default 
_ address while voli are in the monitor. Wtien leaving, the original 

address is reset. Valid unit addresses are 8 to IF. These must be 

— entered in HEX. 

~ @ READ ERROR CHANNEL AND PROCESS DISK COMMANDS 



@ 

@ 51 :filename 

@ 10 

@ RO:newname = oldnome 

@Cl:filename = oidname 

@ VO 

@ Nl:filename,id 



:Displa\- error message and clear 

channel 

Scratch specific file from drive 1 

Initialize disk in drive 

Rename file on drive 

Copy file from drive to drive 1 

Validate or collect disk in drive 

New or Header disk in drive 1 
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The above examples use the same syntax as the wedge program 

supplied with tlie disk drives. ^ 

<file name> LOAD AND EXECUTE FILE IN SEGMENT 15 ^ 

This will load a machine language program Irom the disk and 

execute U. Its use is restricted to segment 15. ^^ 

Z TRANSFER JO SECOND MICROPROCESSOR ^ 

Z ^ 

This command will aJlow you to ut ilize the 8088 when applicable. ^_^ 

X EXIT TO BASIC '-"■ 

X ^ 

This will cause a warm start to BASIC. In a warm start, memorv 

Is not altered in any way and BASIC resumes operation the way it ^-^ 
was before the call to the monitor was made. 



\^ 



v_/ 
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McGraw Hill 



Home and Office Use ofVistCalc. 
D. Castlcwitz and L. Chisauki 



Hands On BASIC with a PET. 
Herbert D. Peckman 



Osborne /McGraw Hill 



Pet/CBM Personal Computer 
Guide. Carroll S. Donahue 



Osborne CP/M User Guide. 
Thorn Hogan 
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PUIiLISHEF^ 



TITLE /AUTHOR 



PET FUN AND GAMES. R. Jeffries 
and G. Fisher 

PET and the IEEE. A. Osborne 
and C. Donahue 

Some Common Basic Programs. 
Lon Poole and Man- Borchers 



P.C. Publications 



The 8086 Book. I^ussell Rector 
and George AJew 

Beginning Self'Tcaching Compu- 
ter Lessons 



Prentice-Hall, Inc. 



Reston Publishing Co. 



The PET Personal Computer for 
Beginners. S. Dunn and V. Morgan 

Pet and the IEEE 488 Bus (GPIB). 
Eugene Fisher and C.W. Jensen 



PET BASIC. Richard Huskell. 

PET Games and Recreation. 
Oge!sv\', Lindsey. and Kunkiu 

PET BASIC— Training Your PET 
Computer. Zaniora, Can'ie, 
and Albrecht 



Total Information Ser^'ices 



Understanding Your PET/CBM: 
Vol. 1 BASIC Programming 

Understanding Your VIC. 
David Schultz 
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USER'S CLUBS, 

MAGAZINES, 

AND THE COMMODORE 

INFORMATION 

NETWORK 



Commodore wants you lo know that our support for users is just 
beginning with your purchase of a Commodore computer. That's 
why we've created two publications with Commodore information 
from around (he world, and a "two- way" computer information 
network full of valuable input by and for Commodore computer 
users in the U.S. and Canada from coast to coast. 

In addition, we wholeheartedly encourage and support the 
growth of Commodore User's Clubs all over the globe. They are an 
excellent source of information for ever\' Commodore computer 
user, from the beginner to the most experienced. 

The magazines and network, which are described below, have 
the most up-to-date information on how to get involved with the 
User's Club in your area 

Furthermore, your local Commodore dealer is an excellent 
source of Commodore support and information. Your dealer can 
alwavs provide literature and hardware support to fill your chang- 
ing computing needs. 

Power/Play: The Home Computer Magazine 

When it comes to entertainment, learning at home, and practi- 
cal home applications, Power/Play is the prime source of infor- 
mation for Commodore computer owners. It directs you to the 
User's Club nearest you and tells you about its activities. It des- 
cribes software, games, programming techniques, telecommuni- 
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cations, and new products. Power/Play is your personal connec- 
tion to other Commodore users, outside software and hardware 
developers, and to Commodore itself. Published quarterly, it's only 
SI 0.00 for a whole year of home computing excitement. 

Coiiuiiodore:The Microcomputer Magazine 

Widely read by educators, business people, and students, as well 
as home computerists. Commodore is our main vehicle for shar 
ing exclusive information on the more technical uses of Commo- 
dore systems. Regular departments cover the business, science, 
and education fields, programming tips, technical tips, and many 
other features of interest to anyone who uses, or is thinking about 
purchasing. Commodore equipment. Commodore is the ideal 
complement to Power/Play. It is published bi-monthly, and a sub- 
script ion costs only S 1 5.00 per vear. 

Commodore Information Network 

The magazine of the future is here today. To supplement your 
.subscriptions to Poirer/Play and Commodore magazines, the 
Commodore Informalion Network — our "paperless magazine" — is 
available now. All you need is a Commodore computer, a telecom- 
munications device called a modem, and your home or business 
telephone. 

Join our computer club, gel help with a computing problem, 
"talk" lo other Commodore friends, or get up-to-the-minute in- 
formation on new products, software, and educational resources. 
Soon you will even be able to save yourself the trouble of typing in 
the program listings you find in Pmver/Play and Commodore by 
'"downloading" directly from the Informalion Network. The Ix-st 
part of the network is that most of the answers to your questions 
are there before you e\en ask them. Hows that for service? 

To ■'caii" our electronic magazine you onlv need a modem and 
subscription lo CompuSen'e". one of the nation's largest tele- 
communications networks. 

Just dial your local number for the CompuServe'" data bank 
nearest yot: and then connect your phone to the modem. When 
the CompuServe" video text appears on your screen, [y'pe "C 
CBM" on your keyboard. When the Commodore Information Net- 
work's table of contents, or "menti," appears on the screen, it's 
your (urn to choose from one of our 16 departments. So make 
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voursellfoinloriablf. and lmijov llie '■]5apei"less nuitiaziiic" ihai all 
ihe odier niat:in>:ines are writinf^ about. 

For more informaiion about the Commodore Information i^el- 
work or about CompuSen^e'. visit your local Commodore dealer 
or contact ComiJuSen.'e"' customer serx'ice at 1-800-848-8990 (in 
Ohio. 614-457-8600), 
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COMMODORE INFORMATIOIV NETWORK 
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Q 
Q 



Main Menu Description 
Direct Access Codes 
Special Commands 
User Questions 
Public Bulletin Board 
Ma.t^azines and Newsletters 
New Product AnnoniicemenLS 
Commodore New Direct 



Commodore Dealers 
Educational Resources 
User Groups 
Descriptions 
Questions and Answers 
Software Tips 
Technical Tips 
Directory Descriptions 
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Index 



ABS function 98 
APPEND 66 
Arroys 

Dimensioning (DIM 
s»Qtement)72, 124-125 
ASC function, 98 
Assigning data 

DATA/READ statements 70-71 , 90 

INPUT statement 78-79 

GET statement 75 

LET sfatemenf 79 
ATN function 98-99 

B 

BACKUP command 47-48, 52 

Duplicating diskettes 47-48 

Disk status errors 47 
BANK statement 66-67 
BASIC 4,0 conimonds (See 

Extended BASIC 4,0) 
BASIC 4.0 statements 

(See Extended BASIC 4.0| 
BLOAD67 
Branching programs 

GOSUB76 

GOTO 76-77 

ON/GOSUB 80-81 

ON/GOTO 81 

RETURN 93 
BSAVE 68 



Calculations 

Arithmetic operators 
32-35 

Calculator keypad 32-34 

Execution order in 
calculations 34-35 

Parentheses in 
calculotions 35 
Colculofor keypad 32-34 
CATALOG 52-53 
CE (clear entry) key 

33-34 
CHRS codes 116-117 
CHRS function 99 
Cleoring the screen 28 
Closing files 

CLOSE command 68, 136 

DCLOSE command 71 
CLR statement 68-69 
CMDstotement 69-70, 135 
COLLECT 53 
Commonds, BASIC 

formot conventions 50-51 

formats 52-65 
CONCAT 54 
Concurrent CP/M9,20-22, 

38-39 
CONT command 54-55 
COPY statement 55-56 
Copying Diskettes 47-48, 

52, 55-56 
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COS functions 99100 
CP''M Operating Syster 

20-22, 38-39 
Cursof control keys 27 



Dolsy-chainlng pei'ipheicils 

42 
DATA stcilemenl 70 71 . 92 

DCLEAR56 57 

DCLOSE71 

Debugging 

CONT 54-55 

DISPOSE 73 

RESUME 92-93 

STOP 93-94 

TRAP 94-95 
DEF FN statement 71 -72 
Defining lunclion in 

programs 71 -72 
Defining function keys 

28-29.60-61 
DELETE statement 57 
Deleting data 

DELele key 27-28 

Deleting o line lESC Dl 
31 

Deleting files from 
diskettes iSCRATCHi 64-65 

Erasing current program 
(NEW command) 62-63 
DIM stoienienl 72 
Dimensioning arrays 

72 
DIRECTORY 57-58 
Disk drives 

Initializing (DCLEAR) 
56-57 

Instolling 42 

Models compatible with 
B Series 19 
Diskettes 

Duplicating diskettes 
47 48 



Diskettes— con*. 

Headenng diskettes 

44-45 
Listing directoiy/catolog 

52 53.57-58 
Loading programs 43 44, 

45-46.58-59,62,67 
Saving programs 46-47, 
59. 64,68 
DISPOSE stctemenl 73 
DLOAD 58-59 
DOPEN 73-74 
DSAVE 59 
DSS47, 109 
Dual microprocessor 9, 

20-22,38-39.122 

Duplicating Diskettes 

47-48,52,55-56 



Editing keys 27 28 

8088 niicroprocessor9, 20-22 38-39, 122 

END statement 74 

ERRS function 94. 100 

Error messages 1 26-1 32 

Error trapping 

CONT 54 55 

DISPOSE 73 

EL 94, 109 

ER94, 109 

ERRS 94, 100 

RESUME 92-93 

STOP 93 94 

TRAP 94-95 
ESCope functions 30-31 
EXP function 100-101 
Extended BASIC 4.0 

Abbreviations 111113 

Coninionds 52-65 

Convenlions m formats 
50-51 

Converting from 
standard BASIC 124-125 

Functions 98-109 

Statements 65-95 
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FOR/TO/STEP 7475 
Format keys 26-27 
Formatting diskettes 

(See HEADER command) 
Formotting output 

PRINT USING statement 
85-89 

PUDEF statement 89-90 

Punctuation marks 1 10 
FRE function 101 
Function keys 28-29, 

60-61 
Functions in progroms 

71-72 



Installation 
additional 

microprocessors 21 -22 
"B" Series computers 
14-13 
INSTR function 101-102 
INT function 102 

K 

KEY statement 28-29, 

60-61 
Key defining 28-29, 60-61 
Keyboard, 26-34, 121 
Keypod 32-34 



GET statement 75 
GETff statement 76 
GOSUB76 
GOTO 76-77 
Graphics mode 26-27 

H 

HEADER command 44-45, 
59-60 

I 

IEEE port, 20, 122 

IF/GOTO 77-78 

IF/THEN/ELSE 77-78 

Improperly closed files 
138 

INPUT 78-79 

INPUTS 79 

insert mode 31 

Inserting date 
INSert key 27-28 
Inserting q line (ESC I) 
31 



LEFT function 102 
LEN function 103 
LET statement 79 
LIST commond 61 -62 
Loading programs 

BLOAD67 

DLOAD 58-59 

LOAD 62 

Prepockoged software 43-44 

Programs 43-44,45-46 
LOG function 103 
Loops 

FOR/TO/STEP/NEXT 74-75, 
79-80 

GOTO 76-77 

IF/GOTO 77-78 

IF/THEN/ELSE 77-78 

ON/GOTO 81 

M 

Machine longuage monitor 

141-144 
Machine language programs 

LoodinglBLOAD)67 

Sovin9(8SAVE}68 

SYS command 94 



I 
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Mathematical funcfions 

toblel20 
Memory mops 

B Series memory mop 
1!9 
Screen meitiory mop 1 1 8 
Merging files 54 
MIDS function 1031 04 
MS-DOS 9. 20-22, 38-39 

N 

NEW commond 62'-63 
NEXT statement 79-80 
Nonerror messages 133 
Normal (text) mode 
26-27 



ON/GOSUB statement 80-81 
ON/GOTO stotementSl 
OPEN command 82, 138 



PEEK 82-83, 104 
Penpherols 18-21 
Plnouts for Input/Output 

devices 121-123 
POKE 83 
POS function 104 
PRINT statement (? on 

calc keypad) 32, 83-84 
PRINT USING statement 

85-89 
PRINTS statement 84-85, 135-136 
Printers 18 
Programmable function 

keys 28-29, 60-61 
PUDEF statement 89-90 



Quote mode 31 



READ 5totement90 
RECORD stotement 91 
Redirecting output (CMD 

statement) 69-70, 135 
REM statement 91 -92 
Renaming programs 

(RENAME commond) 63 
Reserved system symbols 

109-110 
Reserved system 

voriobles 109 
Restarting program 

execution 54-55 
RESTORE statement 92 
RESUME statement 92-93 
RETURN stolement93 
Reverse mode 27, 31 
RIGHTS function 

104-105 
RND function 105 
RS-232 port 19-20, 121, 

137-140 
RUN command 32, 63-64 



Sovlng programs 
BSAVE command 68 
DSAVE command 59 
Replacing programs 47 
SAVE command 46-47, 64 

SCRATCH command 64-65 

Screen display 

Disabling Scroll {ESC M)31 
LIST command 61 -62 
PRINT statement 83-84 
Screen display codes 

114-115 
Screen memory mop 1 18 
Scrolling 30-32 

S crol ling (ESC and 
[3)30-31,32 

SON function 105-106 



156 INDEX 



SID chip register map 

134 
SIN funcfionl06 
Software 9, 38-39 
SPC function 106 
SQR function 106 
STATUS function 

107 
STOP stotement 93-94 
Storing programs (see 

Saving programs) 
STRS function 107-108 
Subroutines 76-77, 

80-81 
SYS Statement 94 



TRAP statement 94-95 
U 

USR function 109 

V 

VAL function 109 
Voriobles (See Assigning 

data) 
VERIFY command 65 



W 



WAIT statement 95 



TAB function 108 
TAN function 108 
TiS function 108, 125 



Z-80 microprocessor 9, 
20-22,38-39,122 
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'B" SERIES QUICK REFERENCE CARD 



SIMPIE VARIABLES 



Nom 



iJ:yf 



70U1I83E'38 
* 3 93873588E - 39 
XY% ■ 37767 
XYS lo355t.hQrOClrri 
r^A £.y Y ivoleiipr or ,i^,...brf (0 9} Vyi.oble 
lofUj^i ( «fh bi* moi <* il>ori 2 chofQcten, but ofily the 1ir»t 



X .1 <i I 



■toil- 



i?f-d 



ARBAV tf AfilAALB 

fype 

S.r>qic D.'ii.-'«i(or 

Ihfep Dirrirniion 
Arruyl of up ro el&ven c 



Nome 
HYii: 

XY|5.5^ 
XYiS S.5I 

ujcd whL'fc needed AMUi-i wiili moiir iKon ele"«iii (^le- 
mirnu "ffd lo be DlM^niioned 

ALGEBRAIC OPBt ATOK 



■ A«.gri, 



aloe to 



' Eupcneritiation 

' Muhipl.{.alian 

/ D...!.or. 

• Addition 

- SubiKKlion 

ftELATlONAi ANO lOGlCAt OPIRATORS 



Noi Equal To 

G'eater Than 
Lc»TI)nriDf EaiTCjIT^, 
GFBotef Than or EqirOf To 
Logical Noi 
Logical And 
Logtca] O' 
r. »>qualil •'■•'wv Orf false 



< - 

NOT 

AND 

OR 

E-prev 

SYSTEM COMMANDS 



DLOAD NAVE 
DSAVE NAME 
tOAD NAME ,8 
SAVE NAME S 
VfBilY NAME 

RUN 
SUN II. 

STOP 
END 

CONT 

PEEKiXj 
POKE X.Y 
SYS ■■■'" 

WAII >,, Y Z 

USR,)(i 



Loodn 






I progiO: 
Sovr> o progioi 
Lood* O piSQtOfri Ifom di^k 
Suvei o piTogfaiTt td duk 
Vtfifiej that piogram wui SAVEd 
wtThoMi en-or* 
£»ec i/res Q program 
fuecuTes program startiria at linf 

Holts execution 

Ends «»* cut ion 

Conl^nuei orogrtim eictulion liOTS 

hne tyhere piogrom wa:. KoltTd 

Returns contenli ol rnemopy tota 

imnX 

Changes contenli ol loco'iort X ic> 

volue Y 

Jumai lo eirtkjfe o mochmc lo*i 

gunt)? program ilorPing or xittf 

ProgFom w^ii* ur^hl coritpniv of 

lot al.oi- X whrr. EORed wi ih Z and 

ANDcd-withY iinonieto 

Ptiiies value ol X lo Q rirtpGhinc 'on- 

gutige subraunne 

EDITING AND FORMATTING COMMANDS 

llST i.lM entire progrnrn 

ll^T A B liltl from line A lo line B 

S£M MiMwig* Commeni nieiwgv tart be lultd bui 

>i rgnorrd during pi09i>0iii cnViO- 

lAftX] Uied.nPKtMT t1oie->iefttj Spot^-iX 

pOaitianiO'^ ICfireii 



PRiNTsAbtonki oolire 
Re:turn>cui-r?nl curjsi posilion 
Poiilkon* curiOf to lell toi^ner of 



POS(X) 
ClPi/HOME 

icreeo 
SHIFT CLR'HOME CVcri «r«en end placei cu'sOi m 

Home poiition 
SHIFT INS/OFl Inierlv ipatu dl turr.^.il cu'ior 

pOiitkO'i 

INS^DtL Df Itlri tfiorocTe' ol Current cuiior 

pOiiTiOrt 

CTRL Pnnn graphics on ivon-olphotittic 

ke^i and occesses contiol lunf lioni 

CRSP<eyi Mov^f-k Cursof up. down. feft. right 

Corrrrnodoic Kpy SiDpi ihe progtum *tom It'olfnng 
Prevvuny fcey ro r^iluit 

ARitAYS AND STRINGS 

DIM A |K, Y Z] Sett [iiD«iirrti^m Subicplf 'for A. rft 

servei ipoce lor [X • T;'V • 1 1' 
[Z • ^\ eJ«mcnli itcrlmg ol A 
(0,0,0) 

R-elufiil number al ihoiaClets ir> XS 
R^iurn^ numisric valwv oi X. coo- 
vH»pi(-d lo a Mriiig 

Rtflurni numeric valu6 of AS, up to 
liril rionnumenc chupocler 
Eeiurrts ASCIt chcroclcr whotC 
code ibX 

Reiui Hi ASCII code *or Firsi thoraC- 
ferolXS 

Relurrn lefimost X choioclert ol AS 
1!«lurni fightmo^l ^ choraclcrl of 
AS 

^eiufrti Y tharncfcri ol A5 Hatirng 
aldicirnfterX 



lEN(XSi 
STRSlXr 

VALlXSl 

CHRSiX, 

ASC;K5 

LEFTS! AS, X^ 
RiGhTSiaS X] 

MlDSlAS.X.r, 



INPUT/OUTPUT COMMANDS 



Ond wOitj lo* 



tNKUl AS OR A PifrNTi, ? on 

user to irn^ier a firing ar value 

INPUT ABC A PRIN fi mpiioye oikJ wotlifdf uiai 
Po HpiHiu value Con n!»o INPUT AS 
Wuili lor user lo ijpf o"e chamC 
fep value no HCTURN needird 
linilialifc^Q s^eiol values tlioT (Ort be 
used by fftAD ilCjlemenl 
Amgns ncjff DATA vatue AS or A 
Reikis dato poinier to iiort REAQ- 

■ ng l*ie DATA liH OgOir^ 

P1?INIv s'ling A= ond vyiue ol A 
^uppie^^esipoc^i^i , lubsdoiolO 
np.ll.tW 



GET AS or A 

DaIa a B , C 



BEAD AS ot A 
RESTORE 



PRINT A 



PROGRAM FLOW 

GOTO X Bionchei »o line X 

f^A-^THfcN10 IF oiWfifion is Hue THEN enecute 

(oHowing pari ol llaiement- IF 

(alw e^eiule rteniJinen^v^nmber 
FOR A - 1 TO 10 Eiieculei oil staivmtrtii between 

FOR 

□ltd toiie^pondifig NEXT, with A 

qoing Irom 1 10 10 by 7 St<0 sue ■* 

I unleu tpecilifrd 

Deliiiei end of loop. A li oph^nQt 

Branches to rubi-Ouiif^fr sterling ot 

line 2000 

f/.arV\ end of^ub'oulme. ReTurrit ro 

itolpment Fot'ow ng most recen' 

GOSUB 
ON X GOTO A,B BiRnJicj loXth Imc number on lijl 

tU 1 bfonchcl to A, en 
ON X GOSUfl A,B B'OT^cties id lubioutm* oi Xih line 

nmnbe' in hli 



STEP? NIXT 



NEXT A 
GOSUB 20OO 



RETURN 
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OWNER'S REGISTRATION CARD 

Please mail this card to Commodore to register 
your computer with us. 

Name: 



Address: 
City: 



Zip Code: 



1. What-is your family's 
present income bracket? 
n less than $14,999 
n $15,000 - $24,999 
D $25,000 - $39,999 
D $40,000 - $59,999 
D $60,000 and above 

3. Are you male or female? 
n Male n Female 

5. Number of Children? 



2. 


Purchaser's ag 


e? 




D 


Under 18 






D 


18- 


24 






D 


25 - 


34 






D 


35- 


49 






D 


over 50 




4. 


Areyo 


u married? 




n 


Yes 


D 


No 



6. What's your educational background? 
D Did not finish high school 

D High School graduate 
D Some College 
D College Graduate 
D Some Graduate School 
D Graduate Degree 

7. What is your primary area of computing interest? 
D Self teaching 

D Education 

D Recreation and Hobby 

D Small business 

D Telecommunications/Timesharing 

D Engineering 

D Productivity 

D Other 
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LIMITED 90'DAY WARRANTY 
COMMODORE PERSONAL COMPUTER SYSTEMS 



Commodore Busmess Machines. Inc. (■"Commodore") warranls lo the original consumer 
purchaser that its Personal computer products ( "UNIT") (") (Not includmg computer programs 
on cassettes or disks) shall be free from any defect in material and workmanship for a period of 
90 days from the date of purchase. If a defect covered by this warranty occurs during this 90 
day warranty period, you should return !he Uf^TIT within such 90 days to: 

Your original dealer or any Full Service Commodore dealer together with a 
copy of your sales slip or similar proof-of-purchase. The dealer will repair the 
defective UNIT under this warranty. 

In the unlikely event that your dealer is unable to repair UNIT or you need assistance in 
locating a Full Service Dealer you may, i( necessary, contact (he Commodore Customer 
Support Group at (215) 436-4200. 

This warranty does not cover damage or malfunctions resulting from improper handling, 
accident, misuSe. abuse, failure of electrical power, use with other products not manufac- 
tured or approved by Cornmodore, damage while m transit for repairs, repairs attempted by 
any unauthorized person or agency, or any other reason not due lo defects in materials or 
workmanship. This warranty is also void if the serial number has been altered, defaced, or 
removed 

ANY IMPLIED WARRANTIES ARISING OUT OF THE SALE OF THIS UNIT INCLUDING BUT 
NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE, ARE LIMITED IN DURATION TO THE ABOVE NINETY (90| DAY 
PERIOD. COMMODORES LIABILITY IS LIMITED SOLELY TO THE REPAIR OR REPLACE- 
MENT OF THE DEFECTIVE UNIT IN ITS SOLE DISCRETION, AND IN NO EVENT SHALL 
INCLUDE DAMAGES FOR LOSS OF USE OR OTHER INCIDENTAL OR CONSEQUENTIAL 
COSTS, EXPENSES, OR DAMAGES INCURRED BYTHE PURCHASER. INCLUDING WITHOUT 
LIMITATION ANY DATA OR INFORMATION WHICH MAY BE LOST OR RENDERED INACCU- 
RATE, EVEN IF COMMODORE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH 
DAMAGES 

All computer programs, whether sold by Commodore or others, are distributed on an "AS 
IS " basis without warranty of any kind. The entire risk as to the performance and suitability of 
such programs is with the purchaser. 

Should the programs {on cassettes or disks) prove defective following [heir purchase, the 
purchaser and not the manufacturer, distributor, or retaiter assumes the full responsibility for 
service or replacement. 

Commodore shall have no liability or responsibility to a purchaser, customer, or any other 
person or entity with respect to any Nabiiity, loss or damage caused or alleged to be caused 
directly or indirectly by any computer programs {on any media) sold by Commodore or others. 
This includes but is not limited to any interruption of service, loss of busmessor anticipatory 
profits or consequential damages resulting from the use or operation of such computer 
programs. 

Commodore shall have no obligation to enhance or update any UNIT once manufactured. 

Some states do not allow limitations on how long any implied warranty lasts or excluslion of 
consequential damages, so the above limitation or exclustion may not apply to you- This 
warranty gives you specific legal rights, and you may also have other rights which vary from 
state 10 state. 

(•) UNITS COVERED UNDER THIS WARRANTY ARE: 

ALL SERIES- 2000, 4000, 8000, 9000 UNITS Peripherals and Iheir Accessories. 
ALL SERIES -C', 'P', 'S', 'BX' UNITS Peripherals and their Accessaries 



C^ commodore 

COMPUTER 



COIVIIX/IODORE ^B' SERIES 

ADVANCED BUSINESS 

IVIACHINES 

THE PRACTICAL. VERSATILE BUSINESS SYSTEM 



Commodore's versatile 'B' Series business microcomputers provide 
powerful corriputing systaris for your most important txEiness needs: word 
processing, record keeping, accouitng, datable management, and a variety 
of other applications. The microconTxiters in this series offer stateKjf-the-art 
technology and superior features: 

• 12BKor256KRAM 

• 8-bit or 16-bit microprocessor 

• Optional tilt and swivel monitor 

• 94-key keytxiard 

• 20 programmable finctJon keys 

• Separate 19-key cateiiator keypad 

• Expandable memory 

• 80 coKjnn by 25 frie screen display 

• Extended BASIC version 4.0 + (66 commands] 

• Compatible with Commodore busriess peripherals 

This maxial describes 'B' Series system features, software appScations, 
technical and BASIC programming information. Your Commodore dealer can 
provide additional up-to-date information on 'B' Series compatible peripherals 
andsoftvrare. 
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COMRJTERS 

Commodore Business Machines, Inc. 
1 200 Wilson Drive • West Chester, PA 1 9380 

Commodore Business Machines, Limited 
3370 Pharmacy Avenue • Agincourt, Ontario, M1W 2K4 
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